Add Gitbook Action to publish HTML, PDF, EPUB, and MOBI

Add Gitbook Action to publish this document in the
gh-pages branch of the same repository in HTML, PDF,
EPUB, and MOBI formats.  The draft and release
versions of the documents are published in different
directories of the gh-pages branch so all published
versions are available for download and online
viewing.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Michael D Kinney <[email protected]>
Reviewed-by: Kevin Shaw <kevin.w.shaw@intel>
Acked-by: Laszlo Ersek <[email protected]>

Author: mdkinney

.bookignore

@@ -0,0 +1,3 @@
+/.github
+.gitignore
+.bookignore

.github/workflows/gitbook-action.yml

@@ -0,0 +1,39 @@
+name: 'Gitbook Action Build'
+on:
+  push:
+    branches:
+      - master
+      - release/*
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout action
+      uses: actions/checkout@v2
+    - name: Get Branch
+      run: |
+        raw=$(git branch -r --contains ${{ github.ref }})
+        branch=${raw/  origin\/}
+        pubdir=${branch/master/draft}
+        pubdir=${pubdir////-}
+        echo "ON_PUSH_BRANCH_NAME=$branch" >> $GITHUB_ENV
+        echo "ON_PUSH_PUBDIR=$pubdir" >> $GITHUB_ENV
+    - name: Gitbook Action
+      uses: zanderzhao/[email protected]
+      with:
+        token: ${{secrets.GITBOOK_ACTION_PERSONAL_TOKEN}}
+        source_branch: ${{env.ON_PUSH_BRANCH_NAME}}
+        publish_branch: gh-pages
+        publish_dir: ${{env.ON_PUSH_PUBDIR}}
+        publish_remove_last_build: true
+        gitbook_pdf: true
+        gitbook_pdf_dir: /
+        gitbook_pdf_name: ${{ github.event.repository.name }}-${{env.ON_PUSH_PUBDIR}}
+        gitbook_epub: true
+        gitbook_epub_dir: /
+        gitbook_epub_name: ${{ github.event.repository.name }}-${{env.ON_PUSH_PUBDIR}}
+        gitbook_mobi: true
+        gitbook_mobi_dir: /
+        gitbook_mobi_name: ${{ github.event.repository.name }}-${{env.ON_PUSH_PUBDIR}}

.gitignore

@@ -5,12 +5,12 @@
 ## Dependency directory
 ## Commenting this out is preferred by some people, see
 ## https://docs.npmjs.com/misc/faq#should-i-check-my-node_modules-folder-into-git
-node_modules
+/node_modules
 
 # Book build output
-_book
+/_book
 
 # eBook build output
-*.epub
-*.mobi
-*.pdf
+/book.epub
+/book.mobi
+/book.pdf

book.json

@@ -4,7 +4,6 @@
     "title"   : "EDK II Module Writer's Guide",
     "version" : "Revision 0.71"
   },
-
-  "plugins": ["puml"],
+  "plugins": ["puml-aleung"],
   "pluginsConfig": {}
 }

styles/epub.css

@@ -1,3 +1,11 @@
+p {
+    font-family: sans, sans-serif, Arial;
+}
+
+body {
+    font-family: sans, sans-serif, Arial;
+}
+
 h1 {
     color: #0860A8;
     font-weight: normal;

styles/mobi.css

@@ -1,3 +1,11 @@
+p {
+    font-family: sans, sans-serif, Arial;
+}
+
+body {
+    font-family: sans, sans-serif, Arial;
+}
+
 h1 {
     color: #0860A8;
     font-weight: bold;

styles/pdf.css

@@ -1,3 +1,11 @@
+p {
+    font-family: sans, sans-serif, Arial;
+}
+
+body {
+    font-family: sans, sans-serif, Arial;
+}
+
 h1 {
     color: #0860A8;
     font-weight: normal;

styles/website.css

@@ -1,3 +1,11 @@
+p {
+    font-family: sans, sans-serif, Arial;
+}
+
+body {
+    font-family: sans, sans-serif, Arial;
+}
+
 h1 {
     color: #0860A8;
     font-weight: normal;