we/jgdr
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

delete article-test / use sample-article in Print archetype. Added notes to Sample article !publish!

Browse source
This commit is contained in:
constantinos 2023-07-17 19:07:10 +03:00
parent 7b533e665d
commit d32d5bdf87
3 changed files with 58 additions and 82 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
archetypes/print.md
View file

@ -3,7 +3,7 @@ title: "{{ replace .Name "-" " " | title }} ⚫ ✉"
date: "{{.Date}}"
author: "editor-put-your-name-here"
draft: true
print: "article/article-test.md"
print: "article/sample-article.md"
---
<!--

58
content/article/article-test.md
View file

@ -1,58 +0,0 @@
---
title: "Article Test ⚫ "
date: "2023-06-24T15:19:05+03:00"
author: "anybody"
draft: true
contributors: [constantinos-miltiadis.md]
keywords:
- draft
abstract: |
The text of your abstract. Max word count...?
---
This is a contribution.
# General
## Submission length
How about:
- No fixed length, however, the journal encourages contributors to submit articles less than 8.000 words. In case your submission exceeds this limit please provide a concise statement why that is necessary.
# Submission checklist
Submit a zip folder including:
- A markdown file of the article.
- A folder with all linked graphics.
Checklist:
- [ ] The article has been proof-read.
- [ ] Consistent use of language (US/UK English).
- [ ] Graphics and other file attachments are included in a subfolder.
- [ ] Article wordcount, excluding bibliography and footnotes, does not exceed 8.000 words. If it does, a brief statement is included to justify that.
- [ ] The submission is
# Citations & citation workflow
- Citation style: [how about an (Author YYYY ) type e.g. Chicago].
## Citation and referencing workflow using Zotero
We strongly recommend the use of [Zotero](https://www.zotero.org/), a free and open source reference manager.
1. Download [Zotero](https://www.zotero.org/)
2. Install the Zotero plugin [Better Bibtex for Zotero](https://retorque.re/zotero-better-bibtex/) (BBZ), which will generate citation keys for each entry.
3. In Zotero, make a collection titled, say, `GDJ`.
4. Drag and drop all the references for your article.
5. The BBZ plugin will generate citation keys.
# Bibliography

80
content/article/sample-article.md
View file

@ -13,11 +13,25 @@ abstract: |
The text of your abstract. Max length..?
---
# Todo
- hint a basic structure (introduction, ... , conclusion )
- Specify
- submission length
- abstract length
- keywords (min amount)
- citation style
- provide a set citation examples (see [bib section](#bib))
- examples of figures / captions
- instructions for submitting artifacts
- provide template in downloadable zip
# Introduction
This is a sample article for submissions.
Contributions are natively processed in Markdown format. For a guide for writing in Markdown see ![Markdown guide](article:markdown-formatting), and ![Markdown bibliography workflow](article:md-workflow).
Contributions are published in Markdown format. For a guide for writing in Markdown see ![Markdown guide](article:md-formatting). For incorporating bibliographic references see ![Markdown bibliographic referencing workflow](article:md-workflow).
However, one can also submit in conventional word processor formats (DOCX, ODT).
@ -25,14 +39,19 @@ However, one can also submit in conventional word processor formats (DOCX, ODT).
[Download submission sample](/sample/dummy-package/dummy-package.txt).
# Submission length
How about:
- No fixed length, however, the journal encourages contributors to submit articles up to 8.000 words. In case your submission exceeds this limit please provide a concise statement why this is necessary.
# Main fields
## Title
> ! Capitalization conventions?
## Abstract
Abstract is to be included in the header file.
If the submission is not provided in Markdown format, clearly mark and place the Abstract *before* the introductory heading of your article.
Abstract is to be included eventually in the frontmatter of the Markdown file, to be displayed as above. For submissions it's probably practical to have a section for the Abstract before the Introduction.
## Keywords
Add three keywords at minimum.
@ -56,7 +75,6 @@ Use up to three levels of headings.
## Images
Supported image formats are:
- SVG (vector)
- PNG (raster)
@ -77,38 +95,54 @@ The examples below use the same graphic exported via Illustrator to:
*Note: to view the full resolution version of an image (web version), right click on an image and select "Open image in new tab". Note also that the text of the SVG graphic is selectable.*
# Citations [??]
# Citations [?]
[Zotero]: https://www.zotero.org/ "free and open source, cross-platform citation management software."
For a guide on how to incorporate bibliographic citations in Markdown see the ![Markdown bibliographic referencing workflow](article:md-workflow). We recommend the use of [Zotero][].
For a guide on how to incorporate bibliographic citations in Markdown see ![Markdown workflow](article:md-workflow). We recommend the use of [Zotero][].
- > Citation style: Chicago?
## Quotes
## Quotes [?]
> Block quotes are used for quotations that are 40 words or more, and are followed by a reference (Author 2015).
For shorter quotations, use in-line quotes, as in "this is a quotation" (Author 2015).
# Conclusion
# Submission checklist
Submit a zip folder including:
- The article of the contribution either in
- a word processor file such as DOCX or ODT (anonymized metadata), or
- a Markdown file, either
- with compiled bibliographic references, or
- together with the bibliography (bib) used.
- [A PDF version of the article?]
- A folder with all linked graphics in full resolution (e.g. `graphics/`).
- Provide necessary artifacts either
- via link to a drive or repository, or
- include them in full as separate `zip` files.
Checklist:
- [ ] Consistent use of EN/US English.
- [ ] Submission has been proof read.
- [ ] Included graphics are provided in a subfolder.
- [ ] The contribution is anonymized.
- [ ] The article has been proof-read.
- [ ] Consistent use of language (US/UK English).
- [ ] Graphics and other file attachments are included in a subfolder.
- [ ] Article wordcount, excluding bibliography and footnotes, does not exceed 8.000 words. If it does, include a brief statement to justify why this is necessary.
- [ ] The submission is anonymized.
For Markdown submissions, submit a zip file including:
- A Markdown file of the article.
- Bibliography included in the Markdown file, or in extra `.bib` file.
- A subfolder including all images (e.g. `graphics/`).
Provide necessary artifacts either
- via link to a drive or repository, or
- include them in full as separate `zip` files.
# Review process
# References
e.g.
1. Editors: Notification of receiving the submission
2. Editors: Notification that the submission is in review or desk rejected.
3. Peer review timeframe, amount of reviewers,
4. Kind of notifications (accept/reject/major/minor, etc.)
5. Publication process / archival of submitted material.
# Conclusion
# Bibliography/References? {#bib}
Compile a sample list of references for:
- book
@ -118,7 +152,7 @@ Compile a sample list of references for:
- website / blog / news post
- film
- Youtube/vimeo video
- presentation
- presentation (e.g. GDC)
- repository
- artifact
- and for games