Watchdog list

In subsequent section, you can find the current todo to get this bar green. Here is a list of some of the books, we migrated to latest latex template and latest stable pillar.

Books in print @ Book on Demand

Books	Build Status	PDF	State	Type	Status
Booklet-TestingInPharo			Published	Microdown
PharoWithStyle			Published	Microdown
NewPharoByExample9			Published	Microdown	Bod but should harvest fix and repository is newPBE and not PBE
Reflective Kernel			Published	Microdown
Building applications with Spec2			Published	Microdown

Next books to be on print @ Book on Demand

Books	Build Status	PDF	State	Type	Status
Booklet-AdvancedMicroProjects			Released	Microdown	Should be revisited for publication
Booklet-DataFrame			Ongoing	Microdown	Bod - Pillar 10.2 - BuildGHNotOk multiple anchors

Previously published books

Books	Build Status	PDF	State	Type	Status
TinyBlog-EN			Published	Microdown	Lulu - Pillar 10.2 - BuildGHOk
TinyBlogTutorial			Published	Microdown	Lulu
Learning OOP	DNU Latex Error but the pdf is still produced	TODO	Released	Microdown	Lulu
Seaside			Ongoing	Microdown	Available in microdown now need a pass

Booklets

Booklets	Build Status	PDF	State	Type	Status
Booklet-ASimpleMemoryGame			Released	Microdown	May need some extra material to be physically printed.
Booklet-ConcurrentProgramming			Released	Microdown	A chapter on monitor would be nice
Booklet-ManagingCode			Released	Microdown
Pharo Graphs			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-Glorp			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-STON			Released	microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-Scraping			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-Smacc			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-LLVMCompilationWithPharo			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-AMiniSchemeInPharo			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-Commander			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-APharoThingsTutorial			Ongoing	Microdown	Bod - Pillar 10.2 - BuildGHOk
Chest			Ongoing	Microdown	Bod - Pillar 10.2 - BuildGHOk
UFFI			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-Voyage			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-ZincHTTP			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Book template			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk
Restore			Released	Microdown	Bod - Pillar 10.2 - BuildGHOk

Drafts

Books	Build Status	PDF	State	Type	Status
Booklet-FunWithInterpreters			Ongoing	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-PharoVirtualMachine			Ongoing	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-Pharo-Graphics			Ongoing	Microdown	Bod - Pillar 10.2 - BuildGHOk
Booklet-CountryTutorial			Ongoing	Microdown	Bod - Pillar 10.2 - BuildGHOk

Super Drafts

Books	Build Status	PDF	State	Type
PatternsOfDesign			Ongoing	Microdown
Booklet-AI-Technics			Ongoing	Microdown
Booklet-Magritte			Ongoing	Microdown
Booklet-Rewriter			Ongoing	Microdown
Booklet-PharoChosenPieces			Ongoing	Microdown
Booklet-ClapCommandLine			Ongoing	Microdown
Booklet-XML			Released	Microdown
101-OOP			Released	Microdown
NewToolsInPharo			Released	Microdown
Booklet-CorePharo			Released	Microdown
Booklet-PharoForPythonists			Released	Microdown
CompilerEssentials			Released	Microdown

To be listed in one of the lists above

• https://github.com/cormas/Booklet-CORMAS Pending PR
• https://github.com/Ducasse/reproducible-research-SE-notes Pending PR
• https://github.com/StevenCostiou/The-Pharo-Debugger-Book Migrated

Old to be migrated to centralized builder

Booklet-CallStackManagement (did not migrate to latest sba because code should be migrated prior)

https://github.com/SquareBracketAssociates/Booklet-CallStackManagement

Troubleshooting

My github action do not launch?

Possible solutions:

• You are missing the workflow file in the .github/workflow/ folder?
• The branch name declared in the workflow file is not the same as in the repository? (master instead of main for example?)

Latex is crying on GH and us too

• you may have to move the CreativeCommons-BYNOCND.pdf into the latex repo out of sbabook
• update sba book

git subrepo pull --force --branch=v0.2.8 support/latex/sbabook

• do not forget to update the template to refer to the new location
• copy the texlive.deps from https://github.com/SquareBracketAssociates/booklet-template/
• during the migration update the workflow to use the branch newVersionOfPillar

name: Book with Pillar

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]
  schedule:
    - cron:  '0 0 * * 0'

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

jobs:
  build:
    uses: SquareBracketAssociates/BookBuilderDashboard/.github/workflows/main.yml@newVersionOfPillar
    with:
      bookname: bkTemplate

• You may have to do

chmod a+x _support/latex/sbabook/ci/install-texlive

All in one

cp ../booklet-template/_support/latex/texlive.deps _support/latex
cp ../booklet-template/_support/latex/CreativeCommons-BYNOCND.pdf _support/latex
cp ../booklet-template/.github/workflows/triggeringPillar10.yml .github/workflows/main.yml
mate .github/workflows/main.yml

"Changing to ND license"
cp ../booklet-template/_support/templates/latex/main.mustache _support/
templates/latex/

git add *
git add .github/*
git commit

For Bod format

Use the correct format in common.tex

\pagelayout{\bodpage}

Add extra pages

\begin{document}

\newpage
\thispagestyle{empty}
\mbox{}
\newpage
\thispagestyle{empty}
\mbox{}

...

My building script is not executable

If you have an error because a building script is not executable you can add the permissions like this:

git update-index --chmod=+x _support/latex/ensure-deps.sh
git ls-files --stage
git commit -m "Make script executable"
git push origin master #or main or another branch name