[edk2-devel] [ATBB-Mitigate_Buffer_Overflow_in_UEFI/master][Patch v2] Add Gitbook Action to publish HTML, PDF, EPUB, and MOBI

Michael D Kinney posted 1 patch 3 years, 5 months ago
Failed in applying to current master (apply log)
There is a newer version of this series
.bookignore                          |  3 +++
.github/workflows/gitbook-action.yml | 39 ++++++++++++++++++++++++++++
.gitignore                           | 16 ++++++++++++
book.json                            | 19 +++++++-------
styles/epub.css                      |  8 ++++++
styles/mobi.css                      |  8 ++++++
styles/pdf.css                       |  8 ++++++
styles/website.css                   |  8 ++++++
8 files changed, 99 insertions(+), 10 deletions(-)
create mode 100644 .bookignore
create mode 100644 .github/workflows/gitbook-action.yml
create mode 100644 .gitignore
[edk2-devel] [ATBB-Mitigate_Buffer_Overflow_in_UEFI/master][Patch v2] Add Gitbook Action to publish HTML, PDF, EPUB, and MOBI
Posted by Michael D Kinney 3 years, 5 months ago
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 <michael.d.kinney@intel.com>
---
 .bookignore                          |  3 +++
 .github/workflows/gitbook-action.yml | 39 ++++++++++++++++++++++++++++
 .gitignore                           | 16 ++++++++++++
 book.json                            | 19 +++++++-------
 styles/epub.css                      |  8 ++++++
 styles/mobi.css                      |  8 ++++++
 styles/pdf.css                       |  8 ++++++
 styles/website.css                   |  8 ++++++
 8 files changed, 99 insertions(+), 10 deletions(-)
 create mode 100644 .bookignore
 create mode 100644 .github/workflows/gitbook-action.yml
 create mode 100644 .gitignore

diff --git a/.bookignore b/.bookignore
new file mode 100644
index 0000000..ed716f0
--- /dev/null
+++ b/.bookignore
@@ -0,0 +1,3 @@
+/.github
+.gitignore
+.bookignore
diff --git a/.github/workflows/gitbook-action.yml b/.github/workflows/gitbook-action.yml
new file mode 100644
index 0000000..917b0d7
--- /dev/null
+++ b/.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/gitbook-action@v1.2.4
+      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}}
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e68dc83
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,16 @@
+# Node rules:
+## Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+## 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
+
+# Book build output
+/_book
+
+# eBook build output
+/book.epub
+/book.mobi
+/book.pdf
diff --git a/book.json b/book.json
index faa83e2..ca020f5 100644
--- a/book.json
+++ b/book.json
@@ -1,10 +1,9 @@
-{
-  "variables" : {
-    "draft"   : "yes",
-    "title"   : "Security Enhancement to Mitigate Buffer Overflow in UEFI",
-    "version" : "Revision 02.0"
-  },
-
-  "plugins": ["puml"],
-  "pluginsConfig": {}
-}
\ No newline at end of file
+{
+  "variables" : {
+    "draft"   : "yes",
+    "title"   : "Security Enhancement to Mitigate Buffer Overflow in UEFI",
+    "version" : "Revision 02.0"
+  },
+  "plugins": ["puml-aleung"],
+  "pluginsConfig": {}
+}
diff --git a/styles/epub.css b/styles/epub.css
index be6b609..87d4f8f 100644
--- a/styles/epub.css
+++ b/styles/epub.css
@@ -1,3 +1,11 @@
+p {
+    font-family: sans, sans-serif, Ariel;
+}
+
+body {
+    font-family: sans, sans-serif, Ariel;
+}
+
 h1 {
     color: #0860A8;
     font-weight: normal;
diff --git a/styles/mobi.css b/styles/mobi.css
index db1ca60..0d85d04 100644
--- a/styles/mobi.css
+++ b/styles/mobi.css
@@ -1,3 +1,11 @@
+p {
+    font-family: sans, sans-serif, Ariel;
+}
+
+body {
+    font-family: sans, sans-serif, Ariel;
+}
+
 h1 {
     color: #0860A8;
     font-weight: bold;
diff --git a/styles/pdf.css b/styles/pdf.css
index be6b609..87d4f8f 100644
--- a/styles/pdf.css
+++ b/styles/pdf.css
@@ -1,3 +1,11 @@
+p {
+    font-family: sans, sans-serif, Ariel;
+}
+
+body {
+    font-family: sans, sans-serif, Ariel;
+}
+
 h1 {
     color: #0860A8;
     font-weight: normal;
diff --git a/styles/website.css b/styles/website.css
index cc1f1e5..1a20751 100644
--- a/styles/website.css
+++ b/styles/website.css
@@ -1,3 +1,11 @@
+p {
+    font-family: sans, sans-serif, Ariel;
+}
+
+body {
+    font-family: sans, sans-serif, Ariel;
+}
+
 h1 {
     color: #0860A8;
     font-weight: normal;
-- 
2.29.2.windows.2



-=-=-=-=-=-=-=-=-=-=-=-
Groups.io Links: You receive all messages sent to this group.
View/Reply Online (#67508): https://edk2.groups.io/g/devel/message/67508
Mute This Topic: https://groups.io/mt/78224451/1787277
Group Owner: devel+owner@edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org]
-=-=-=-=-=-=-=-=-=-=-=-


Re: [edk2-devel] [ATBB-Mitigate_Buffer_Overflow_in_UEFI/master][Patch v2] Add Gitbook Action to publish HTML, PDF, EPUB, and MOBI
Posted by Laszlo Ersek 3 years, 5 months ago
On 11/13/20 06:53, Michael D Kinney wrote:
> 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 <michael.d.kinney@intel.com>
> ---
>  .bookignore                          |  3 +++
>  .github/workflows/gitbook-action.yml | 39 ++++++++++++++++++++++++++++
>  .gitignore                           | 16 ++++++++++++
>  book.json                            | 19 +++++++-------
>  styles/epub.css                      |  8 ++++++
>  styles/mobi.css                      |  8 ++++++
>  styles/pdf.css                       |  8 ++++++
>  styles/website.css                   |  8 ++++++
>  8 files changed, 99 insertions(+), 10 deletions(-)
>  create mode 100644 .bookignore
>  create mode 100644 .github/workflows/gitbook-action.yml
>  create mode 100644 .gitignore
> 
> diff --git a/.bookignore b/.bookignore
> new file mode 100644
> index 0000000..ed716f0
> --- /dev/null
> +++ b/.bookignore
> @@ -0,0 +1,3 @@
> +/.github
> +.gitignore
> +.bookignore
> diff --git a/.github/workflows/gitbook-action.yml b/.github/workflows/gitbook-action.yml
> new file mode 100644
> index 0000000..917b0d7
> --- /dev/null
> +++ b/.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/gitbook-action@v1.2.4
> +      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}}
> diff --git a/.gitignore b/.gitignore
> new file mode 100644
> index 0000000..e68dc83
> --- /dev/null
> +++ b/.gitignore
> @@ -0,0 +1,16 @@
> +# Node rules:
> +## Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
> +.grunt
> +
> +## 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
> +
> +# Book build output
> +/_book
> +
> +# eBook build output
> +/book.epub
> +/book.mobi
> +/book.pdf
> diff --git a/book.json b/book.json
> index faa83e2..ca020f5 100644
> --- a/book.json
> +++ b/book.json
> @@ -1,10 +1,9 @@
> -{
> -  "variables" : {
> -    "draft"   : "yes",
> -    "title"   : "Security Enhancement to Mitigate Buffer Overflow in UEFI",
> -    "version" : "Revision 02.0"
> -  },
> -
> -  "plugins": ["puml"],
> -  "pluginsConfig": {}
> -}
> \ No newline at end of file
> +{
> +  "variables" : {
> +    "draft"   : "yes",
> +    "title"   : "Security Enhancement to Mitigate Buffer Overflow in UEFI",
> +    "version" : "Revision 02.0"
> +  },
> +  "plugins": ["puml-aleung"],
> +  "pluginsConfig": {}
> +}
> diff --git a/styles/epub.css b/styles/epub.css
> index be6b609..87d4f8f 100644
> --- a/styles/epub.css
> +++ b/styles/epub.css
> @@ -1,3 +1,11 @@
> +p {
> +    font-family: sans, sans-serif, Ariel;
> +}
> +
> +body {
> +    font-family: sans, sans-serif, Ariel;
> +}
> +
>  h1 {
>      color: #0860A8;
>      font-weight: normal;
> diff --git a/styles/mobi.css b/styles/mobi.css
> index db1ca60..0d85d04 100644
> --- a/styles/mobi.css
> +++ b/styles/mobi.css
> @@ -1,3 +1,11 @@
> +p {
> +    font-family: sans, sans-serif, Ariel;
> +}
> +
> +body {
> +    font-family: sans, sans-serif, Ariel;
> +}
> +
>  h1 {
>      color: #0860A8;
>      font-weight: bold;
> diff --git a/styles/pdf.css b/styles/pdf.css
> index be6b609..87d4f8f 100644
> --- a/styles/pdf.css
> +++ b/styles/pdf.css
> @@ -1,3 +1,11 @@
> +p {
> +    font-family: sans, sans-serif, Ariel;
> +}
> +
> +body {
> +    font-family: sans, sans-serif, Ariel;
> +}
> +
>  h1 {
>      color: #0860A8;
>      font-weight: normal;
> diff --git a/styles/website.css b/styles/website.css
> index cc1f1e5..1a20751 100644
> --- a/styles/website.css
> +++ b/styles/website.css
> @@ -1,3 +1,11 @@
> +p {
> +    font-family: sans, sans-serif, Ariel;
> +}
> +
> +body {
> +    font-family: sans, sans-serif, Ariel;
> +}
> +
>  h1 {
>      color: #0860A8;
>      font-weight: normal;
> 

Per previous discussion:

  [edk2-devel] Tianocore-docs Gitbook offline document status (PDF, EPUB, MOBI)

  https://edk2.groups.io/g/devel/message/66308
  https://www.redhat.com/archives/edk2-devel-archive/2020-October/msg00526.html

Acked-by: Laszlo Ersek <lersek@redhat.com>



-=-=-=-=-=-=-=-=-=-=-=-
Groups.io Links: You receive all messages sent to this group.
View/Reply Online (#67538): https://edk2.groups.io/g/devel/message/67538
Mute This Topic: https://groups.io/mt/78224451/1787277
Group Owner: devel+owner@edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org]
-=-=-=-=-=-=-=-=-=-=-=-