Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/squarebracketassociates/bookbuilderdashboard
To get an overview of the book building status
https://github.com/squarebracketassociates/bookbuilderdashboard
Last synced: about 2 months ago
JSON representation
To get an overview of the book building status
- Host: GitHub
- URL: https://github.com/squarebracketassociates/bookbuilderdashboard
- Owner: SquareBracketAssociates
- Created: 2020-11-13T08:43:19.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-21T10:29:40.000Z (2 months ago)
- Last Synced: 2024-10-21T15:16:58.163Z (2 months ago)
- Homepage:
- Size: 312 KB
- Stars: 2
- Watchers: 10
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](https://github.com/SquareBracketAssociates/Booklet-TestingInPharo) |  | [](https://github.com/SquareBracketAssociates/Booklet-TestingInPharo/releases/download/latest/TestingInPharo.pdf) | Published | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [PharoWithStyle](https://github.com/SquareBracketAssociates/Booklet-PharoWithStyle) |  | [](https://github.com/SquareBracketAssociates/Booklet-PharoWithStyle/releases/download/latest/PharoWithStyle.pdf) | Published | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [NewPharoByExample9](https://github.com/SquareBracketAssociates/NewPharoByExample9) |  | [](https://github.com/SquareBracketAssociates/NewPharoByExample9/releases/download/latest/PharoByExample9-wip.pdf) | Released | Microdown | Bod but should harvest fix and repository is newPBE and not PBE |
### Next books to be on print @ Book on Demand
| Books | Build Status | PDF | State | Type | Status |
| -------------------------------- |:-------------:| -----:| -----:| -----:| -----:|
| [Reflective Kernel](https://github.com/SquareBracketAssociates/Booklet-AReflectiveKernel) | [](https://github.com/SquareBracketAssociates/Booklet-AReflectiveKernel/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-AReflectiveKernel/releases/download/latest/reflectiveKernel-wip.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Building applications with Spec2](https://github.com/SquareBracketAssociates/BuildingApplicationWithSpec2) |  | [](https://github.com/SquareBracketAssociates/BuildingApplicationWithSpec2/releases/download/latest/Spec2-wip.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk|
| [Booklet-AdvancedMicroProjects](https://github.com/SquareBracketAssociates/Booklet-AdvancedMicroProjects) | [](https://github.com/SquareBracketAssociates/booklet-AdvancedMicroProjects/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/booklet-AdvancedMicroProjects/releases/download/latest/MoocCompanion.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-DataFrame](https://github.com/SquareBracketAssociates/Booklet-DataFrame) | [](https://github.com/SquareBracketAssociates/Booklet-DataFrame/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-DataFrame/releases/download/latest/DataFrame-wip.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHNotOk multiple anchors|
### Previously published books
| Books | Build Status | PDF | State | Type | Status |
| -------------------------------- |:-------------:| -----:| -----:| -----:| -----:|
| [TinyBlog-EN](https://github.com/SquareBracketAssociates/TinyBlog-EN) |  | [](https://github.com/SquareBracketAssociates/TinyBlog-EN/releases/download/latest/TinyBlog-EN.pdf) | Published | Microdown | Lulu - Pillar 10.2 - BuildGHOk |
| [TinyBlogTutorial](https://github.com/SquareBracketAssociates/TinyBlogTutorial) |  | [](https://github.com/SquareBracketAssociates/TinyBlogTutorial/releases/download/latest/TinyBlog-FR.pdf) | Published | Microdown | Lulu |
| [Learning OOP](https://github.com/SquareBracketAssociates/LearningOOPWithPharo) | DNU Latex Error but the pdf is still produced | TODO | Released | Microdown | Lulu |
| [Seaside](https://github.com/SquareBracketAssociates/DynamicWebDevelopmentWithSeaside) | [](https://github.com/SquareBracketAssociates/DynamicWebDevelopmentWithSeaside/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/DynamicWebDevelopmentWithSeaside/releases/download/latest/DynamicWebDev-wip.pdf) | Ongoing | Microdown |
### Booklets
| Booklets | Build Status | PDF | State | Type | Status |
| -------------------------------- |:-------------:| -----:| -----:| -----:| -----:|
| [Booklet-ASimpleMemoryGame](https://github.com/SquareBracketAssociates/Booklet-ASimpleMemoryGame) | [](https://github.com/SquareBracketAssociates/Booklet-ASimpleMemoryGame/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-ASimpleMemoryGame/releases/download/latest/index.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-ConcurrentProgramming](https://github.com/SquareBracketAssociates/Booklet-ConcurrentProgramming) |  | [](https://github.com/SquareBracketAssociates/Booklet-ConcurrentProgramming/releases/download/latest/ConcurrentProgrammingInPharo.pdf) | Pre-Published | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-ManagingCode](https://github.com/SquareBracketAssociates/Booklet-ManagingCode) |  | [](https://github.com/SquareBracketAssociates/Booklet-ManagingCode/releases/download/latest/ManagingCodeInPharo.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Pharo Graphs](https://github.com/SquareBracketAssociates/Booklet-PharoGraphs) |  | [](https://github.com/SquareBracketAssociates/Booklet-PharoGraphs/releases/download/latest/PharoGraphs.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-Glorp](https://github.com/SquareBracketAssociates/Booklet-Glorp) | [](https://github.com/SquareBracketAssociates/Booklet-Glorp/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-Glorp/releases/download/latest/glorp.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-STON](https://github.com/SquareBracketAssociates/Booklet-STON) | [](https://github.com/SquareBracketAssociates/Booklet-STON/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-STON/releases/download/latest/ston.pdf) | Released | microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-Scraping](https://github.com/SquareBracketAssociates/Booklet-Scraping) | [](https://github.com/SquareBracketAssociates/Booklet-Scraping/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-Scraping/releases/download/latest/scrapping-wip.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-Smacc](https://github.com/SquareBracketAssociates/Booklet-Smacc) | [](https://github.com/SquareBracketAssociates/Booklet-Smacc/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-Smacc/releases/download/latest/smacc-wip.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-LLVMCompilationWithPharo](https://github.com/SquareBracketAssociates/Booklet-LLVMCompilationWithPharo) | [](https://github.com/SquareBracketAssociates/Booklet-LLVMCompilationWithPharo/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-LLVMCompilationWithPharo/releases/download/latest/LLVM-C-Tutorial-WIP.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-AMiniSchemeInPharo](https://github.com/SquareBracketAssociates/Booklet-AMiniSchemeInPharo) | [](https://github.com/SquareBracketAssociates/Booklet-AMiniSchemeInPharo/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-AMiniSchemeInPharo/releases/download/latest/AMiniScheme-wip.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-Commander](https://github.com/SquareBracketAssociates/Booklet-Commander) | [](https://github.com/SquareBracketAssociates/Booklet-Commander/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-Commander/releases/download/latest/Commander-wip.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-APharoThingsTutorial](https://github.com/SquareBracketAssociates/Booklet-APharoThingsTutorial) | [](https://github.com/SquareBracketAssociates/Booklet-APharoThingsTutorial/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-APharoThingsTutorial/releases/download/latest/PharoThings-wip.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Chest](https://github.com/SquareBracketAssociates/Chest) | [](https://github.com/SquareBracketAssociates/Chest/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Chest/releases/download/latest/Chest-wip.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [UFFI](https://github.com/SquareBracketAssociates/booklet-uFFI) | [](https://github.com/SquareBracketAssociates/Booklet-uFFI/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-uFFI/releases/download/latest/UnifiedFFI.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-Voyage](https://github.com/SquareBracketAssociates/Booklet-Voyage) | [](https://github.com/SquareBracketAssociates/Booklet-Voyage/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-Voyage/releases/download/latest/Voyage.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-ZincHTTP](https://github.com/SquareBracketAssociates/Booklet-ZincHTTP) | [](https://github.com/SquareBracketAssociates/Booklet-ZincHTTP/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-ZincHTTP/releases/download/latest/zinc.pdf) | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Companion Mooc ](https://github.com/SquareBracketAssociates/booklet-AdvancedMicroProjects) | [](https://github.com/SquareBracketAssociates/booklet-AdvancedMicroProjects/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [ Book template ](https://github.com/SquareBracketAssociates/booklet-template) | [](https://github.com/SquareBracketAssociates/booklet-template/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk
| [ Restore ](https://github.com/SquareBracketAssociates/booklet-restore) | [](https://github.com/SquareBracketAssociates/booklet-restore/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
### Drafts
| Books | Build Status | PDF | State | Type | Status |
| -------------------------------- |:-------------:| -----:| -----:| -----:| -----:|
| [Booklet-FunWithInterpreters](https://github.com/SquareBracketAssociates/Booklet-FunWithInterpreters) | [](https://github.com/SquareBracketAssociates/Booklet-FunWithInterpreters/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-FunWithInterpreters/releases/download/latest/fun-with-interpreters-wip.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-PharoVirtualMachine](https://github.com/SquareBracketAssociates/Booklet-PharoVirtualMachine) | [](https://github.com/SquareBracketAssociates/Booklet-PharoVirtualMachine/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-PharoVirtualMachine/releases/download/latest/vm-wip.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-Pharo-Graphics](https://github.com/SquareBracketAssociates/Booklet-Graphics) | [](https://github.com/SquareBracketAssociates/Booklet-Graphicsactions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-Graphics/releases/download/latest/pharo-graphics.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-CountryTutorial](https://github.com/SquareBracketAssociates/booklet-CountryTutorial) | [](https://github.com/SquareBracketAssociates/booklet-CountryTutorial/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/booklet-CountryTutorial/releases/download/latest/countryTutorial.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk |
### Super Drafts
| Books | Build Status | PDF | State | Type |
| -------------------------------- |:-------------:| -----:| -----:| -----:|
| [PatternsOfDesign](https://github.com/SquareBracketAssociates/PatternsOfDesign) | [](https://github.com/SquareBracketAssociates/PatternsOfDesign/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/PatternsOfDesign/releases/download/latest/Pattern-wip.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHOk|
| [Booklet-AI-Technics](https://github.com/SquareBracketAssociates/Booklet-AI-Technics) | [](https://github.com/SquareBracketAssociates/Booklet-AI-Technics/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-AI-Tecnics/releases/download/latest/AI-Technics.pdf) | Ongoing | Microdown | Bod - Pillar 10.2 - BuildGHNotOk multiple anchors |
| [Booklet-Magritte](https://github.com/SquareBracketAssociates/Booklet-Magritte) | [](https://github.com/SquareBracketAssociates/Booklet-Magritte/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-Maggrite/releases/download/latest/magritte-wip.pdf) | Ongoing | Microdown |
| [Booklet-Rewriter](https://github.com/SquareBracketAssociates/Booklet-Rewriter) | [](https://github.com/SquareBracketAssociates/Booklet-Rewriter/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-Rewriter/releases/download/latest/rewriter-wip.pdf) | Ongoing | Microdown |
| [Booklet-PharoChosenPieces](https://github.com/SquareBracketAssociates/Booklet-PharoChosenPieces) | [](https://github.com/SquareBracketAssociates/Booklet-PharoChosenPieces/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-PharoChosenPieces/releases/download/latest/chosenpieces-wip.pdf) | Ongoing | Microdown |
| [Booklet-ClapCommandLine](https://github.com/SquareBracketAssociates/Booklet-ClapCommandLine) | [](https://github.com/SquareBracketAssociates/Booklet-ClapCommandLine/actions/workflows/main.yml) | [](https://github.com/SquareBracketAssociates/Booklet-ClapCommandLine/releases/download/latest/Clap-wip.pdf) | Ongoing | Microdown |
| [Booklet-XML ](https://github.com/SquareBracketAssociates/Booklet-XML) | [](https://github.com/SquareBracketAssociates/Booklet-XML/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [ 101-OOP ](https://github.com/SquareBracketAssociates/101-OOP ) | [](https://github.com/SquareBracketAssociates/101-OOP/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [NewToolsInPharo ](https://github.com/SquareBracketAssociates/NewToolsInPharo ) | [](https://github.com/SquareBracketAssociates/NewToolsInPharo/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-CorePharo ](https://github.com/SquareBracketAssociates/booklet-CorePharo) | [](https://github.com/SquareBracketAssociates/booklet-CorePharo/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [Booklet-PharoForPythonists ](https://github.com/SquareBracketAssociates/Booklet-PharoForPythonists ) | [](https://github.com/SquareBracketAssociates/Booklet-PharoForPythonists/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| [CompilerEssentials ](https://github.com/SquareBracketAssociates/Booklet-CompilerEssentials) | [](https://github.com/SquareBracketAssociates/Booklet-CompilerEssentials/actions/workflows/main.yml) | | Released | Microdown | Bod - Pillar 10.2 - BuildGHOk |
| | | | | |
# 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](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:
```bash
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
```