Illustration update !publish!

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 
 

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. 
+<figcaption>Table 1: Sample table.</figcaption> 
 
 ## 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
 

content/article/submission-guide.md

@@ -10,8 +10,8 @@ abstract: |
   Submission guide. 
 ---
 
-<!--
 
+<!--
 This journal is committed to the use of free and open source tools, workflows and platforms, for the production of open, accessible, and resilient knowledge. 
 
 Contributions are submitted as Markdown files, and can include