Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/omarespejel/ethlatam2024
https://github.com/omarespejel/ethlatam2024
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/omarespejel/ethlatam2024
- Owner: omarespejel
- License: mit
- Created: 2024-03-13T08:45:43.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-03-13T08:45:45.000Z (10 months ago)
- Last Synced: 2024-03-27T22:37:22.362Z (10 months ago)
- Language: CSS
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Marp Slides Template
[Use this template!](https://github.com/codebytes/marp-slides-template/generate)
Create a Marp presentation site that can be built and published on [GitHub Pages] using this minimal template. The site features:
- Marp integration
- A GitHub Pages / Actions workflow for build and publish ([See a preview](http://chris-ayers.com/marp-slides-template/))
- A DevContainer/CodeSpace configuration with Marp and Markdown preview extensions
- Chrome installation for PDF and PowerPoint slide creation on Linux
## Customization
Feel free to customize the sites created with this template as you like!
## Getting Started
1. Click "[use this template]" to create a new site.
2. Update the content of `slides/Slides.md` with your own presentation.
## Custom Themes
This template includes four custom themes in the `slides/themes` folder:
- custom
- custom-default (based on the built-in default theme)
- custom-gaia (based on the built-in gaia theme)
- custom-uncover (based on the built-in uncover theme)
To use a custom theme, edit the relevant css file and add its reference in the front matter of `Slides.md`. For example, to use `custom-default` add the following to the `Slides.md` front matter:
```markdown
---
marp: true
theme: custom-default
---
```
For additional themes, add them to the devcontainer and follow the [Marp custom theme documentation](https://marpit.marp.app/theme-css).
## Publishing on GitHub Pages
1. In your GitHub repo, navigate to `Settings` > `Pages` > `Build and deployment`.
2. Select `Source`: `GitHub Actions`.
3. If any Actions failed, go to the `Actions` tab and click on `Re-run jobs`.
## Local Build and Preview
1. Install [Visual Studio Code](https://code.visualstudio.com/).
2. Install the [Marp for VS Code extension](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode).
3. Open `slides/Slides.md` in VS Code.
## Licensing and Attribution
This repository is licensed under the [MIT License]. Reuse or extend the code as you wish, but include the original license. The deployment GitHub Actions workflow is based on GitHub's starter workflows.
## Resources
- [Use this template](https://github.com/codebytes/marp-slides-template/generate)
- GitHub Pages: [https://docs.github.com/en/pages](https://docs.github.com/en/pages)
- CommonMark markdown syntax: [https://commonmark.org/help/](https://commonmark.org/help/)
- Marp Official Repository: [https://github.com/marp-team/marp](https://github.com/marp-team/marp)
- Marp Official Documentation: [https://marpit.marp.app/markdown](https://marpit.marp.app/markdown)
- Marp for VS Code Documentation: [https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)