Alpha version of the translated book and huge french version improvements (#36)

* Adding initial translation in english

* Exact translations for citations

* Drastically improved english version, reworded small part of fr chapter

* Fixed links

* Now supporting CI for both languages

* Fished links

* Fished links

* Fished links

* Fixed references

* Fixed MD links to titles, adapted FR links to en-US or en-CA resources, adapted salaries to US ones, adapted some explanation for americans

* removed 'in french' mentions

* Improved README for english version

* Added english files and drastically improved translations

* Improved presentation of readme

* Added book's landing page

* Adjusted visuals

* Editing links

* Updated links

* Updated link

* Massive correction of spelling, expressions and formatting.

* Improved display of links to books

* Fixed wording

* Added semicolons formalism

* Formatting table

* Added reference to retex/debrief

* Added newpage at some table locations

* Bumping version to 1.1.0-alpha

* Improved PDF version layout and updated citation reference

* Fixed link fragment

* Updated CITATION reference

* Updating condition on which the check-404-links is run

* Fixed broken links

* Increasing timeout for latribune.fr

* Avoiding timeout for latribune.fr

Author: flavienbwk

.404-links.yml

@@ -30,6 +30,8 @@ ignore:
     - https://www.nic.in/servicecontents/national-cloud # 503
     - https://www.gov.uk/government/publications/defence-artificial-intelligence-strategy # Timeout
     - https://www.defense.gouv.fr/ema/actualites/voeux-du-chef-detat-major-armees # Timeout
+    - https://nsf.dev.nato.int/ # Timeout
+    - https://www.latribune.fr/entreprises-finance/industrie/aeronautique-defense/satellites-europeens-lances-par-spacex-la-terrible-defaite-de-l-europe-spatiale-937632.html # Timeout (protection)
 delay:  # Perform a pause of X ms at each call matching the url
   'https://gitlab.com': 500
   'https://gitlab.biterg.io': 1000

.github/workflows/markdownchecks.yml

@@ -9,7 +9,7 @@ jobs:
   # Only on main or PR to main
   check-404-links:
     name: Check for dead links
-    if: github.ref == 'refs/heads/main' || (github.event_name == 'pull_request' && github.head_ref == 'refs/heads/main')
+    if: github.ref == 'refs/heads/main' || (github.event_name == 'pull_request' && github.event.pull_request.base.ref == 'main')
     runs-on: ubuntu-20.04
     steps:
       - name: Checkout

.github/workflows/publish.yml

@@ -12,7 +12,7 @@ jobs:
 
     steps:
 
-      - name: That's funny
+      - name: That's a prank
         shell: bash
         run: |
           echo "Updating a published book is not currently natively possible through Amazon APIs :)"

.github/workflows/render.yml

@@ -10,8 +10,8 @@ on:
 
 jobs:
 
-  render-book:
-    name: Render FR book
+  render-books:
+    name: Render books
     runs-on: ubuntu-20.04
     steps:
       - name: Extract branch name
@@ -60,36 +60,51 @@ jobs:
         run: |
           mkdir -p "$HOME/.local/share/fonts"
           cp ./fra/templates/fonts/* "$HOME/.local/share/fonts"
+          cp ./eng/templates/fonts/* "$HOME/.local/share/fonts"
 
       - name: Render PDF
         run: |
           sed -i -E "s/date: .+/date: ${{ steps.date.outputs.date }} - ${{ env.BOOK_VERSION }}/g" ./fra/metadata.yml
-          cd ./fra && make pdf
+          cd ./fra && make pdf && cd -
+          cd ./eng && make pdf && cd -
 
       - name: Render HTML
         run: |
-          cd ./fra && make html
+          cd ./fra && make html && cd -
+          cd ./eng && make html && cd -
 
       - uses: actions/upload-artifact@v3
         with:
-          name: book-pdf-${{ env.BOOK_VERSION }}
+          name: book-fr-pdf-${{ env.BOOK_VERSION }}
           path: ./fra/build/pdf/book.pdf
           retention-days: 1
 
       - uses: actions/upload-artifact@v3
         with:
-          name: book-html-${{ env.BOOK_VERSION }}
+          name: book-fr-html-${{ env.BOOK_VERSION }}
           path: ./fra/build/html/
           retention-days: 1
 
+      - uses: actions/upload-artifact@v3
+        with:
+          name: book-en-pdf-${{ env.BOOK_VERSION }}
+          path: ./eng/build/pdf/book.pdf
+          retention-days: 1
+
+      - uses: actions/upload-artifact@v3
+        with:
+          name: book-en-html-${{ env.BOOK_VERSION }}
+          path: ./eng/build/html/
+          retention-days: 1
+
 
   # Pictures in the book may be referenced at some place in the text.
   # Ex: \ref{fig:name} in the text to reference the \label{fig:name} illustration.
   #
   # When badly referenced, pandoc generates a double questionmarks ("??") in the place
   # of the latex tags. This Action checks if there are no "??" in the generated PDF.
-  check_latex_references:
-    needs: render-book
+  check-latex-references:
+    needs: render-books
     name: Check valid latex references
     runs-on: ubuntu-22.04
     steps:
@@ -115,29 +130,47 @@ jobs:
           exit 1
         fi
 
-    - name: Download artifact
+    - name: Download FR artifact
       uses: actions/download-artifact@v3
       with:
-        name: book-pdf-${{ env.BOOK_VERSION }}
+        name: book-fr-pdf-${{ env.BOOK_VERSION }}
         path: ./
 
-    - name: Get text from book
+    - name: Get FR text from book
       run: |
         pdftotext ./book.pdf
 
-    - name: Get text from book
+    - name: Get FR text from book
       run: |
         if grep -q "??" ./book.pdf; then
           echo "The file contains the string '??'"
         else
           echo "The file does not contain the string '??'"
         fi
 
+    - name: Download EN artifact
+      uses: actions/download-artifact@v3
+      with:
+        name: book-en-pdf-${{ env.BOOK_VERSION }}
+        path: ./
+
+    - name: Get EN text from book
+      run: |
+        pdftotext ./book.pdf
 
-  check_version_change:
+    - name: Get EN text from book
+      run: |
+        if grep -q "??" ./book.pdf; then
+          echo "The file contains the string '??'"
+        else
+          echo "The file does not contain the string '??'"
+        fi
+
+
+  check-version-change:
     name: "Check version change"
     runs-on: ubuntu-22.04
-    needs: check_latex_references
+    needs: check-latex-references
     outputs:
       version_changed: ${{ steps.check.outputs.version_changed }}
     steps:
@@ -163,9 +196,9 @@ jobs:
           fi
 
 
-  deploy_to_gh_pages:
-    if: needs.check_version_change.outputs.version_changed == 'true' && (github.ref == 'refs/heads/main')
-    needs: check_version_change
+  deploy-to-gh-pages:
+    if: needs.check-version-change.outputs.version_changed == 'true' && (github.ref == 'refs/heads/main')
+    needs: check-version-change
     runs-on: ubuntu-22.04
     name: Deploy to GitHub Pages
 
@@ -191,14 +224,25 @@ jobs:
     - name: Download artifact
       uses: actions/download-artifact@v3
       with:
-        name: book-html-${{ env.BOOK_VERSION }}
-        path: output/
+        name: book-fr-html-${{ env.BOOK_VERSION }}
+        path: output/fra/
+
+    - name: Download artifact
+      uses: actions/download-artifact@v3
+      with:
+        name: book-en-html-${{ env.BOOK_VERSION }}
+        path: output/eng/
 
     - name: Optimize images
       run: |
         sudo apt-get install -y jpegoptim optipng
         find ./output/ -iname '*.jpg' -exec jpegoptim {} \; -o -iname '*.png' -exec optipng {} \;
 
+    - name: Copy default index files
+      run: |
+        cp ./index.html ./output/
+        cp -r ./images ./output/
+
     - name: Deploy to GitHub Pages
       uses: peaceiris/actions-gh-pages@v3
       with:
@@ -209,8 +253,8 @@ jobs:
 
 
   release:
-    if: needs.check_version_change.outputs.version_changed == 'true' && (github.ref == 'refs/heads/main')
-    needs: check_version_change
+    if: needs.check-version-change.outputs.version_changed == 'true' && (github.ref == 'refs/heads/main')
+    needs: check-version-change
     runs-on: ubuntu-22.04
     name: Generate book files for release
 
@@ -233,10 +277,16 @@ jobs:
           exit 1
         fi
 
-    - name: Download PDF artifact
+    - name: Download FR PDF artifact
+      uses: actions/download-artifact@v3
+      with:
+        name: book-fr-pdf-${{ env.BOOK_VERSION }}
+        path: ./
+
+    - name: Download EN PDF artifact
       uses: actions/download-artifact@v3
       with:
-        name: book-pdf-${{ env.BOOK_VERSION }}
+        name: book-en-pdf-${{ env.BOOK_VERSION }}
         path: ./
 
     - name: Get version

.gitignore

@@ -2,6 +2,8 @@
 ./html/*
 !./html/.gitkeep
 
+PREFACE.md
+
 *.$*
 git-story_media/
 

CITATION.cff

@@ -4,7 +4,7 @@ authors:
 - family-names: "BERWICK"
   given-names: "Flavien"
   orcid: "https://orcid.org/0009-0002-4542-0925"
-title: "Le DevOps pour transformer les institutions"
-version: 1.0.0
-date-released: 2023-10-01
+title: "Scaling institutions with DevOps"
+version: 1.1.0
+date-released: 2023-11-12
 url: "https://github.com/flavienbwk/book-devops"

README.md

@@ -9,6 +9,11 @@
     </a>
 </p>
 
+<h4 align="center">:us:</h4>
+<h3 align="center"><a href="./eng/README.md" alt="Access the book in english version">Scaling Institutions with DevOps</a><sup></sup></h3>
+<p align="center"><i>The pragmatic decision-makers' guide to understanding and acting.</i></p>
+<p align="center" style="color: gray; font-size: 0.9em;">Paperback and ebook with foreword</p>
+
 <p align="center">
     <img src="./fra/images/cover_a5_source.png" width="128px"/>
     <img src="./fra/images/fourthcover_a5_source.png" width="128px"/>
@@ -19,10 +24,6 @@
 <p align="center"><i>Le guide des décideurs pragmatiques pour comprendre et agir.</i></p>
 <p align="center" style="color: gray; font-size: 0.9em;">Livre broché et ebook préfacés</p>
 
-<h4 align="center">:uk:</h4>
-<h3 align="center">Scaling Institutions with DevOps<sup><a href="#footnote-1">[1]</a></sup></h3>
-<p align="center"><i>The pragmatic decision-makers' guide to understanding and acting.</i></p>
-
 <br/>
 
 ## What is it ?
@@ -35,11 +36,15 @@ As a DevOps advocate, I had to make this book GitOps-compliant, this is why it i
 
 Here are the different ways to access this writing :
 
-- [Markdown version (FR)](./fra/README.md)
-- [HTML version (FR)](https://book-devops.berwick.fr)
-- [Ebook version](https://www.amazon.fr/DevOps-pour-transformer-institutions-pragmatiques-ebook/dp/B0CKHV5QB7) (FR)
-- [Paperback book](https://www.amazon.fr/DevOps-pour-transformer-institutions-pragmatiques/dp/B0CKJ6SLV3) (FR)
-- [Hardcover book](https://www.amazon.fr/DevOps-pour-transformer-institutions-pragmatiques/dp/B0CKJ651K9) (FR)
+| Type             | French                                                                                                                      | English                                                   |
+| ---------------- | --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| Web version      | [Lire maintenant](https://book-devops.berwick.fr/fra/index.html)                                                            | [Read now](https://book-devops.berwick.fr/eng/index.html) |
+| Markdown version | [Lire maintenant](./fra/README.md)                                                                                          | [Read now](./fra/README.md)                               |
+| Ebook version    | [Amazon](https://www.amazon.fr/dp/B0CKHV5QB7) / [Google Books](https://play.google.com/store/books/details?id=3u_bEAAAQBAJ) | _Soon_                                                    |
+| Paperback book   | [Amazon](https://www.amazon.fr/dp/B0CKJ6SLV3)                                                                               | _Soon_                                                    |
+| Hardcover book   | [Amazon](https://www.amazon.fr/dp/B0CKJ651K9)                                                                               | _Soon_                                                    |
+
+> The original book was written in French. The English version was reworked to include america-related examples and use cases.
 
 ## Summary
 
@@ -62,6 +67,7 @@ _That said, this way of writing is very convenient for not being annoyed by comp
 It automatically :
 
 <!-- - [Checks spells](https://github.com/check-spelling/check-spelling/blob/main/.github/workflows/spelling.yml) of english-written texts -->
+
 - [Validates Markdown](https://github.com/marketplace/actions/markdown-linting-action) format
 - Renders a PDF version on _develop_ and _main_
 - [Updates](./.github/workflows/publish.yml) the Amazon physical version book through their API

VERSION

@@ -1 +1 @@
-1.0.1
+1.1.0-alpha

eng/.gitignore

@@ -0,0 +1,4 @@
+build/
+*.log
+
+PREFACE.md