Dasharo User Group Presentations

This repository contains presentations from previous Dasharo User Group meetings and scripts related to the creation of content in those presentations.

Historically we used remarkjs with our own remark-templates, but since DUG#7 we switched to slidev.

Usage

slidev (>= DUG#10)

1. Initialize submodules:

git submodule update --init --checkout

1. Render slides

./slidev-template/scripts/render-slides.sh [slides_file]

Example:

./slidev-template/scripts/render-slides.sh pages/dug_10/x-dasharo-dbx-uc-ci.md

1. Open content in browser on http://127.0.0.1:8000

Export presentation

1. Export the desired presentation:

./slidev-template/scripts/ci/gen_slides.sh pages/dug_10/dug10.metadata

PDFs will be in slidev-template/output.

slidev (>= DUG#7)

Installation

1. Install the slidev-template submodule: git submodule update --init --remote slidev-template

2. Go to the submodule directory: cd slidev-template

Usage

Start presentation

1. Start the desired presentation: ./scripts/local-preview.sh pages/dug_7/1-greetings-agenda.md

2. Open content in browser on http://127.0.0.1:8000

Export presentation

1. Export the desired presentation: ./scripts/generate-pdf.sh ../pages/ram-wipe.md

remarkjs (< DUG#7)

• Clone repository

• Initialize submodules

  git submodule update --init --recursive --checkout

• Run local HTTP server e.g.

  python -m http.server

• Open content in browser on http://0.0.0.0:8000

Common issues

Error: ENOSPC: System limit for number of file watchers reached

There is a hard limit for the number of files observed by processes using inotify in linux. Slidev uses it to monitor for changes and update the render. If the amount of files in this repository becomes too big, or if there are other programs that tend to monitor file changes, (like IDEs) opened, the limit might get reached and slidev will crash.

Read the current limit:

cat /proc/sys/fs/inotify/max_user_watches

Set a new limit:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

Warning: it can lead to more files being observed resulting in more system resources (RAM&CPU) being used.

Contribution

• Please feel free to create issues for improvement ideas and bugs, as well as pull requests to fix any issues.

• Releases will occur quarterly, aligned with the DUG and vPubs schedule.

• If you intend to provide code improvements, please install all dependencies by running:

  pip install -r requirements.txt

• Before pushing code for review, ensure that pre-commit run --all-files does not return any issues.