workshop-template
  • Advocacy Workshop
  • Introduction
    • Exercise Title
    • Pre-work
    • resources
      • Admin Guide
      • Contributors
      • mkdocs examples
      • Additional resources
Powered by GitBook
On this page
  • Tips and conventions
  • Screenshots

Was this helpful?

Advocacy Workshop

NextIntroduction

Last updated 4 years ago

Was this helpful?

This is a template for workshops hosted on GitHub Pages using Material for MkDocs. To view it online, go to:

Create a new repo based off this template, and use the following folders as a guide:

- data (any data (CSV, JSON, etc files) to be used)
- docs (this is where the workshop is documented)
|_ <folder-n> (these are exercises for the workshop)
  |_README.md (the steps for the exercise, in Markdown)
|_ README.md (this will appear on the gitbook home page)
- notebooks (any Jupyter notebooks can go here)
- src (any application source code can go here)
.mkdocs.yaml (configuration for mkdocs)
.travis.yaml (runs markdownlint by default)
README.md (only used for GitHub.com)

Tips and conventions

Screenshots

Screenshots look better if they are full page. Use to create a nice border around images with this command:

magick mogrify -bordercolor gray -border 2
https://ibm.github.io/repo-name
ImageMagick