fixes #13 - include generated PDF in HTML site

- generate the PDF in appendix folder
- add generated PDF to .gitignore
- add a thumbnail of the PDF in images
- add link to PDF in appendix chapter

Author: PhilippSalvisberg

.gitignore

@@ -11,6 +11,7 @@
 /MANIFEST
 /site
 /pdf
+/docs/9-appendix/PLSQL-and-SQL-Coding-Guidelines.pdf
 
 # Distribution files
 /dist

docs/9-appendix/appendix.md

@@ -1,6 +1,16 @@
 # Appendix 
 
-## A - Mapping new guidelines to prior versions
+## A - PL/SQL & SQL Coding Guidelines as PDF
+
+These guidelines are primarily produced in [HTML](https://trivadis.github.io/plsql-and-sql-coding-guidelines/) using [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/). 
+
+However, we provide these guidelines also as [PDF](PLSQL-and-SQL-Coding-Guidelines.pdf) produced by [wkhtmltopdf](https://wkhtmltopdf.org/).
+
+[![Trivadis PL/SQL & SQl Coding Guidelines in PDF format](../images/pdf-thumbnail.png)](PLSQL-and-SQL-Coding-Guidelines.pdf)
+
+The formatting is not perfect, but it should be adequate for those who want to work with offline documents.
+
+## B - Mapping new guidelines to prior versions
 
 Old Id  | New Id | Text | Severity | Change-ability | Efficiency | Maintain-ability | Portability | Reliability | Reusability | Security | Testability
 :-----: | :-----:| ---- | :------: | :------------: | :--------: | :--------------: | :---------: | :---------: | :---------: | :------: | :---------:

docs/images/pdf-thumbnail.png

@@ -7,6 +7,7 @@ function create_target_dir(){
 
 function copy_resources() {
     cp ${DATA_DIR}/mkdocs.yml ${TARGET_DIR}/mkdocs.yml
+    cp -r ${DATA_DIR}/custom-theme ${TARGET_DIR}/custom-theme
     cp -r ${DATA_DIR}/docs/images ${TARGET_DIR}/docs
     cp -r ${DATA_DIR}/docs/stylesheets ${TARGET_DIR}/docs/stylesheets
 }
@@ -73,7 +74,7 @@ function convert_to_pdf(){
                 cover ../docs/cover.html \
                 toc \
                 --xsl-style-sheet stylesheets/toc.xsl \
-                index.html ${DATA_DIR}/PLSQL-and-SQL-Coding-Guidelines.pdf
+                index.html ${DATA_DIR}/docs/9-appendix/PLSQL-and-SQL-Coding-Guidelines.pdf
 }
 
 DATA_DIR="$(cd "$(dirname "${0}")/../.." && pwd)"