fixup image paths for PDF and ePub

Author: jon gadsden

.github/workflows/ci.yaml

@@ -68,7 +68,7 @@ jobs:
           args: >-
             --from=markdown
             --output=publish/OWASP_Developer_Guide.draft.pdf
-            --resource-path="draft/assets/images:draft"
+            --resource-path="draft/assets/images:draft/assets:draft"
             draft/title.pdf.yaml
             draft.markdown
 
@@ -78,7 +78,7 @@ jobs:
           args: >-
             --from=markdown
             --output=publish/OWASP_Developer_Guide.draft.epub
-            --resource-path="draft/assets/images:draft"
+            --resource-path="draft/assets/images:draft/assets:draft"
             draft/title.yaml
             draft.markdown
 

.lycheeignore

@@ -19,3 +19,7 @@ https://mvnrepository.com/artifact/org.owasp.esapi/esapi
 # do not harass dockerhub
 https://hub.docker.com/r/owasp/threat-dragon/tags
 https://hub.docker.com/r/webgoat/webgoat
+
+# lychee gets confused with the Jekyl image paths
+www-project-developer-guide/assets/images/sdlc_diag.png
+www-project-developer-guide/assets/images/owasp-wayfinder.png

.markdownlint.yaml

@@ -6,7 +6,7 @@ link-fragments: false
 
 # MD013 - Line length
 MD013:
-  code_block_line_length: 120
+  code_block_line_length: 125
   code_blocks: true
   heading_line_length: 80
   headings: true

contributing.md

@@ -80,10 +80,13 @@ To run these checks locally before pushing a commit, run these commands from the
 1. Link checker: `lychee --max-retries 5 --exclude-path './_includes/*.html' './**/*.md'`
 2. Markdown linter: `markdownlint-cli2  **/*.md`
 3. Spell checker: `pyspelling --config .spellcheck.yaml`
-4. PDF and ePub:
-    1. `tail -n +14 -q $(find draft -name "*[0-9]*.md") > draft.markdown`
-    2. `pandoc -f markdown -o draft.pdf --resource-path="draft/assets/images:draft" draft/title.pdf.yaml draft.markdown`
-    3. `pandoc -f markdown -o draft.epub --resource-path="draft/assets/images:draft" draft/title.yaml draft.markdown`
+4. commands to create PDF and ePub outputs:
+
+```text
+tail -n +14 -q $(find draft -name "*[0-9]*.md") > draft.markdown
+pandoc -f markdown -o draft.pdf --resource-path="draft/assets/images:draft/assets:draft" draft/title.pdf.yaml draft.markdown
+pandoc -f markdown -o draft.epub --resource-path="draft/assets/images:draft/assets:draft" draft/title.yaml draft.markdown
+```
 
 Follow instructions to install the command line [lychee][lychee-install] and [pandoc][pandoc-install].