This repository contains slides listing topics for stage at Bluewind. Slides are prepared using Markdown files, that will be rendered as HTML files using Remark based templates (see credits for details).
Slides language is English.
Please clone this repository including submodules:
$ git clone <this repo>
$ cd <this repo folder>
$ git submodule update --init
$ # or in one command
$ git clone --recursive <this repo>
- open the relevant markdown file with an editor
- modify the content using normal markdown sintax with an eye to specific meanings for Remark based slides as found in the credits
- enjoy the final result by opening the corresponding HTML file in a browser
user@host:~/code/stages-topic⟫ nano existing_slides.md
user@host:~/code/stages-topic⟫ firefox existing_slides.html
- create a copy of existing markdown and HTML files, with a new name for both
- modify the HTML file changing all references to its old name to the new name
- modify and add content to the markdown file
- enjoy the final result by opening the corresponding HTML file in a browser
- add the new files under git control
user@host:~/code/stages-topic⟫ cp existing_slides.md new_slides.md
user@host:~/code/stages-topic⟫ cp existing_slides.html new_slides.html
user@host:~/code/stages-topic⟫ sed -i.bak 's/existing_slides/new_slides/' new_slides.html
user@host:~/code/stages-topic⟫ nano new_slides.html
user@host:~/code/stages-topic⟫ firefox new_slides.html
- copy the useful image in
assets
subfolder - use normal markdown sintax to include the image in a slide
When distributing slides it can be useful to prepare PDF files out of markdown sources, because printing rendered HTML slides to PDF from the browser gives strange results.
The best converter found is decktape:
https://github.com/astefanutti/decktape
and a docker image for easy usage of the tool is also available.
Please note that good results are obtained by processind HTML pages published to a server, so in this example Github pages are used.
# Convert all slides to PDF files
# and write them inside pdf folder
for f in *.html; do \
docker run --rm -v `pwd`:/slides astefanutti/decktape \
https://stefanoco.github.io/stage-topics/$f pdf/${f%.*}.pdf; \
done
Handy way of including images embedded in css (and html if applicable) files is preparing base64 version and including the resulting ASCII string.
user@host:~/code/stages-topic⟫ cat assets/image.png |base64 -w0>b64.txt
This is useful while customising the slides template by modifying the css file:
user@host:~/code/stages-topic⟫ nano remark/remark-template-bw.css
user@host:~/code/stages-topic⟫ sudo apt-get install nodejs-legacy
user@host:~/code/stages-topic⟫ sudo apt-get install npm
user@host:~/code/stages-topic⟫ sudo npm install markdown-to-slides -g
user@host:~/code/stages-topic⟫ markdown-to-slides 1_requirements.md -o 1_requirements.html -s remark/remark-template-bw.css
This is deprecated now: please use instead the existing .html
files
directly, they will include .md
sources on the fly.