- JavaScript 38.4%
- CSS 33.5%
- HTML 21.6%
- Shell 6.5%
| css | ||
| images | ||
| js | ||
| reveal.js@75dff6f515 | ||
| .gitignore | ||
| .gitmodules | ||
| git-crash-course-en.md | ||
| index.html | ||
| README.md | ||
| run.sh | ||
git-crash-course
Introduction to Git written for the RaspiBO makerspace.
Italian version
Italian version available here: https://git.lattuga.net/alberanid/git-crash-course
Build & run
Requirements: Git and Python 3. Node.js, npm and a build step are not needed: the reveal.js submodule includes ready-to-use JavaScript and CSS.
Run:
$ ./run.sh
On the first run, the reveal.js submodule is downloaded (an Internet connection is required). Open http://127.0.0.1:8000 in your browser; press Ctrl+C to stop the server. The script also works when launched from another directory.
To change the port: PORT=8080 ./run.sh. To make the server accessible
on the local network: HOST=0.0.0.0 ./run.sh.
The launcher serves the project files directly. To publish the slides on a static web server, also initialize and include the reveal.js submodule.
Presentation
The reveal.js submodule is pinned to
reveal.js 6.0.2
(commit 75dff6f515d2d08df0c32cf2b7328b89425c6f25). The Markdown,
syntax highlighting, zoom and notes plugins load from the compiled files in
reveal.js/dist/. No npm dependencies are needed.
To update reveal.js, choose a stable upstream release and check it out in the
submodule (replace <version> with the release tag):
$ git -C reveal.js fetch --tags origin
$ git -C reveal.js checkout --detach <version>
$ python3 -m http.server 8000 --bind 127.0.0.1
Check the slides at http://127.0.0.1:8000, update the version and commit above,
and include the changed reveal.js submodule pointer in the parent repository's
commit. Use Python directly to test a candidate release: ./run.sh restores
the submodule commit recorded in the parent repository's index.
The framework's assets and plugins are maintained in the submodule; this
repository only keeps the presentation's own styles and scripts.
Use the arrow keys to navigate; the URL preserves the current slide. Click a diagram to enlarge it, or select it with Tab and press Enter. Esc or the “Close” button closes the image. Ctrl/Cmd-click opens the image in another tab. Image zoom uses a native HTML dialog and requires a modern browser, without jQuery or Bootstrap.
On desktop, the file states slide places the text and diagram side by side; on small screens, it uses a single column and allows long content to scroll.
Otherwise...
Slides are in markdown format and can be directly consulted
License
Copyright 2017-2026 Davide Alberani da@mimante.net, RaspiBO info@raspibo.org
This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License: http://creativecommons.org/licenses/by-sa/4.0/
reveal.js and its bundled dependencies have their own licenses; see reveal.js LICENSE. The original reveal.js license notice is also preserved in LICENSE.revealjs.