feat/scripts: support generating PDFs for platforms

[kbdharun]

Changes

As discussed in the chatroom, this PR adds a way to generate custom PDFs for specific platforms manually. Currently, we use python3 render.py <../../pages> to generate PDFs (tldr-book.pdf by default) and there is a -o or --output flag to give a custom name to the PDF.

This PR adds a new optional flag -p or --platform, allowing pages to be generated for the specified platform alone. For example, python3 render.py ../../pages -p android will generate a PDF file named tldr-book-android.pdf.

You can pass multiple platforms as arguments, for example, python3 render.py ../../pages -p android sunos will generate a PDF file named tldr-book-android+sunos.pdf.

In the case of custom file names, the platform name is just appended behind the filename, for example python3 render.py ../../pages -p android sunos -o tldr-book.pdf will generate a file named tldr-book-android+sunos.pdf.

Reference Outputs

(venv) kbdharun@homeserver:~/Downloads/tldr/scripts/pdf$ python3 render.py ../../pages -p android sunos
Rendered page 1 of the directory android
Rendered page 2 of the directory android
Rendered page 3 of the directory android
Rendered page 4 of the directory android
Rendered page 5 of the directory android
Rendered page 6 of the directory android
Rendered page 7 of the directory android
Rendered page 8 of the directory android
Rendered page 9 of the directory android
Rendered page 10 of the directory android
Rendered page 11 of the directory android
Rendered page 12 of the directory android
Rendered page 13 of the directory android
Rendered page 14 of the directory android
Rendered page 1 of the directory sunos
Rendered page 2 of the directory sunos
Rendered page 3 of the directory sunos
Rendered page 4 of the directory sunos
Rendered page 5 of the directory sunos
Rendered page 6 of the directory sunos
Rendered page 7 of the directory sunos
Rendered page 8 of the directory sunos
Rendered page 9 of the directory sunos

Converting all pages to PDF...

Created tldr-book-android+sunos.pdf in the current directory!

(venv) kbdharun@homeserver:~/Downloads/tldr/scripts/pdf$ python3 render.py ../../pages -p androi
No pages found for platform androi. Skipping.

(venv) kbdharun@homeserver:~/Downloads/tldr/scripts/pdf$ python3 render.py ../../pages -p android -o "tldr-books.pdf"
Rendered page 1 of the directory android
Rendered page 2 of the directory android
Rendered page 3 of the directory android
Rendered page 4 of the directory android
Rendered page 5 of the directory android
Rendered page 6 of the directory android
Rendered page 7 of the directory android
Rendered page 8 of the directory android
Rendered page 9 of the directory android
Rendered page 10 of the directory android
Rendered page 11 of the directory android
Rendered page 12 of the directory android
Rendered page 13 of the directory android
Rendered page 14 of the directory android

Converting all pages to PDF...

Created tldr-books-android.pdf in the current directory!

Reference assets

Assets generated in the above steps:

tldr-book-android+sunos.pdf
tldr-books-android.pdf

Checklist

• All changes have been tested and verified
• The code has been formatted in black
• README has been updated

[Magrid0]

Looks good to me!