From d19183d68b39db3793862e6140e2b043dd53ec41 Mon Sep 17 00:00:00 2001 From: constantinos Date: Sat, 15 Jul 2023 16:39:43 +0300 Subject: [PATCH] Illustration update !publish! --- content/article/markdown-formatting.md | 15 ++-- content/article/sample-article.md | 65 +++++++++--------- content/article/submission-guide.md | 2 +- static/markdown-guide/zotero-citation-key.png | Bin 0 -> 20010 bytes .../markdown-guide/zotero-export-options.png | Bin 0 -> 7704 bytes .../jgdr-test-illustration-3x.png | Bin .../{ => graphics}/jgdr-test-illustration.svg | 0 7 files changed, 42 insertions(+), 40 deletions(-) create mode 100644 static/markdown-guide/zotero-citation-key.png create mode 100644 static/markdown-guide/zotero-export-options.png rename static/sample/{ => graphics}/jgdr-test-illustration-3x.png (100%) rename static/sample/{ => graphics}/jgdr-test-illustration.svg (100%) diff --git a/content/article/markdown-formatting.md b/content/article/markdown-formatting.md index 2159045..7ec9d2d 100644 --- a/content/article/markdown-formatting.md +++ b/content/article/markdown-formatting.md @@ -151,24 +151,25 @@ Avoid image formats that are lossy and can introduce artifacts (e.g. JPG). ``` The examples below use the same graphic put together in Illustrator and exported to: -- SVG (file size: 3KB) -- PNG (file size: 56KB; upscaled 3 times to 2100x900; optimized for text; transparent background) +- SVG (file size: 3KB; export optimized for text; selectable text) +- PNG (file size: 56KB; export resolution x3 @ 2100x900; transparent background) *Image formatting example*: ``` -![Figure 1: Sample illustration in SVG (vector format).](static/sample/jgdr-test-illustration.svg "(Optional mouse-over text description) This is a SVG vector image.") +![Figure 1: Sample illustration in SVG (vector format).](/sample/graphics/jgdr-test-illustration.svg "(Optional mouse-over text description) This is a SVG vector image.") -![Figure 2: Sample illustration in PNG (raster format); exported from Illustrator: type-optimized, transparent background, size x3.](static/sample/jgdr-test-illustration-3x.png "(Optional mouse-over text) This a PNG raster image.") +![Figure 2: Sample illustration in PNG (raster format); exported from Illustrator: type-optimized, transparent background, export resolution x3.](/sample/graphics/jgdr-test-illustration-3x.png "(Optional mouse-over text) This a PNG raster image.") ``` *Appearance*: -![Figure 1: Sample illustration in SVG (vector format).](static/sample/jgdr-test-illustration.svg "(Optional mouse-over text description) This is a SVG vector image.") -![Figure 2: Sample illustration in PNG (raster format); exported from Illustrator: type-optimized, transparent background, size x3.](static/sample/jgdr-test-illustration-3x.png "(Optional mouse-over text) This a PNG raster image.") +![Figure 1: Sample illustration in SVG (vector format).](/sample/graphics/jgdr-test-illustration.svg "(Optional mouse-over text description) This is a SVG vector image.") + +![Figure 2: Sample illustration in PNG (raster format); exported from Illustrator: type-optimized, transparent background, size x3.](/sample/graphics/jgdr-test-illustration-3x.png "(Optional mouse-over text) This a PNG raster image.") -*Note: to open the full resolution version of an image, right click on an image and select Open image in new tab.* +*Note: to view the full resolution version of an image, right click on an image and select "Open image in new tab".* ## Tables diff --git a/content/article/sample-article.md b/content/article/sample-article.md index 35a7f2b..b249a65 100644 --- a/content/article/sample-article.md +++ b/content/article/sample-article.md @@ -16,7 +16,9 @@ abstract: | # Introduction This is a sample article for submissions. -Contributions are natively processed in Markdown format. For a guide about writing in Markdown see ![Markdown guide](article:markdown-formatting). +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). + + However, one can also submit in conventional word processor formats (DOCX, ODT). # Submission sample package @@ -50,7 +52,7 @@ Use up to three levels of headings. | Item 1 | Item 2| Item 3| | Item 5 | Item 6| Item 7| -Table 1: Sample table. +
Table 1: Sample table.
## Images @@ -65,37 +67,23 @@ Place graphics in a subfolder e.g. `graphics/`. > - What identifier to use ? (Figure / Image/ Graphic?) > - !Images should appear **before/after** the first mention, and should be referred to in full, as in Figure 1 (not fig. 1). -*Image formatting pseudocode*: -``` -![Image 1: Caption.](path/to/image.png) +The examples below use the same graphic exported via Illustrator to: +- SVG (optimized for text; with selectable text) --> 3KB +- PNG (upscaled 3 times: 2100x900; transparent background) --> 56KB -![Image 2: Caption.](path/to/image.png "Optional mouse-over text description.") -``` - -The examples below use the same graphic put together in Illustrator and exported to: -- SVG --> 3KB -- PNG (upscaled 3 times: 2100x900, optimized for text; with transparent background) --> 56KB - -*Image formatting example*: -``` -![Figure 1: Sample illustration in SVG (vector format).](static/sample/jgdr-test-illustration.svg "(Optional mouse-over text description) This is a SVG vector image.") - -![Figure 2: Sample illustration in PNG (raster format); exported from Illustrator: type-optimized, transparent background, size x3.](static/sample/jgdr-test-illustration-3x.png "(Optional mouse-over text) This a PNG raster image.") -``` - -*Appearance*: +![Figure 1: Sample illustration in SVG (vector format).](/sample/graphics/jgdr-test-illustration.svg "(Optional mouse-over text description) This is a SVG vector image.") +![Figure 2: Sample illustration in PNG (raster format); tansparent background; export resolution x3.](/sample/graphics/jgdr-test-illustration-3x.png "(Optional mouse-over text description) This a PNG raster image.") -![Figure 1: Sample illustration in SVG (vector format).](static/sample/jgdr-test-illustration.svg "(Optional mouse-over text description) This is a SVG vector image.") -![Figure 2: Sample illustration in PNG (raster format); exported from Illustrator: type-optimized, transparent background, size x3.](static/sample/jgdr-test-illustration-3x.png "(Optional mouse-over text) This a PNG raster image.") +*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 [??] +[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 ![Markdown workflow](article:md-workflow). We recommend the use of [Zotero][]. +- > Citation style: Chicago? -# Citations - -We recommend the use of [Zotero](https://www.zotero.org/). - -> Citation style: Chicago? ## Quotes @@ -111,14 +99,27 @@ Checklist: - [ ] Included graphics are provided in a subfolder. - [ ] The contribution is anonymized. -Submit a zip file including: +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 folder including all images (e.g. `graphics`). -- Provide necessary artifacts - - via link to drive, repository, or - - include them in full as `zip` files. +- 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. # References +Compile a sample list of references for: +- book +- book chapter +- conference paper +- journal paper +- website / blog / news post +- film +- Youtube/vimeo video +- presentation +- repository +- artifact +- and for games diff --git a/content/article/submission-guide.md b/content/article/submission-guide.md index 513e350..497cfec 100644 --- a/content/article/submission-guide.md +++ b/content/article/submission-guide.md @@ -10,8 +10,8 @@ abstract: | Submission guide. --- -