--- title: "New Article Archetype 📑" date: "2023-07-13T14:15:10+03:00" author: "anybody" contributors: ["constantinos-miltiadis.md"] draft: false keywords: - archetype - internal - guide abstract: | (INTERNAL) This is a copy of the archetype for new articles, and includes instructions for editing and publishing a new `article` item, found at `root/archetypes/article.md` --- If creating a new entry via the terminal: - The Hugo terminal command for creating a new `article` is: ``` hugo new article/article-short-title.md ``` This will create new file at `content/article/article-short-title.md`. The new file will be created according to the archetype for articles at `root/archetypes/article.md`. The new file will be created as a draft (`draft: true`) and will contain the instruction steps below. Please complete all required steps before committing or publishing new content. If creating a new entry via the online preview page: - the new entry will be empty. Please use the sample [YAML header below](#yaml) as starting point, and also copy to the new file the [instructions](#instructions) provided below. # Sample YAML header {#yaml} ``` --- title: "Title sample ⚫ 📑" date: "2023-07-13T14:15:10+03:00" author: "file-creator-put-your-name-here" contributors: ["jane-contributor.md"] draft: true keywords: - draft abstract: | The text of your abstract. --- ``` # Instructions for article-file creator/editor {#instructions} 0. [x] Put a checkmark to all items of this list that have been completed. This, by changing: > `1. [ ]` to `1. [x]` 1. [ ] **File naming**: Follow ![conventions for article file-naming](article:int-conventions). Example: > `i5-short-title.md` (where i5 is issue 5) 2. [ ] (File editor) **Insert your name** in the `author` field inside "quotation marks" as in: > `author: "creators-name"` 3. [ ] Set the `title` to the **title** of the article as in: > `title: "An Answer to the Question: What is Game Design Research"` 4. [ ] Create **entries for article contributors** -- if they are not there -- and add their bio/info. 5. [ ] **Add the article's author(s)** in the `contributors` field as above (comma separated; inside quotation marks; including extension): > `contributors: ["jane-contributor.md", "some-other.md"]` 6. [ ] Add **article keywords**. Follow exact formatting as above, otherwise the file/site will break. ``` keywords: - keyword one - keyword two ``` 7. [ ]  Fill the **abstract** following exact formatting like above, otherwise the site will break. 8. [ ] **Parent article to issue**: go to `content/issue/some-issue.md` and add the name of this file (not title) to the field `has_articles`. Example: > `has_articles: ["this-articles-file-name.md"]` 9. [ ] **Add article content** text below this section. 10. [ ] **Log potential problems** with this article by making another check-list below (commented sample lists provided below). 11. [ ] **Git commit and push** if/when applicable; providing a commit message describing your changes. 12. [ ] **Set the draft flag** accordingly. **False will make this public**: only do that when ready to publish. Leave `draft: true` when in-progress. 13. [ ] Feel free to put this block inside comments, to be able to view the actual content properly. 14. [ ] Delete this section when all is in order. 15. Done!