Files
webawesome/CONTRIBUTING.md
Lea Verou 471cb0287d Document API around code examples
cc @claviska
2024-12-04 16:25:35 -05:00

24 lines
873 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Contributing to Web Awesome
Before contributing, please review the contributions guidelines at:
[webawesome.com/docs/resources/contributing](https://webawesome.com/docs/resources/contributing)
## Website Architecture
### Code Examples
`/docs/_utils/code-examples.js` is a small 11ty plugin that turns the code examples into previews. It relies on a client-side script of the same name that lives in /docs/assets/scripts and gets loaded into the sites template.
That takes care of rendering standard code blocks. It supports certain modifier classes:
- `example`: opts a code snippet in to live demo rendering
- `no-edit`: removes the codepen button
- `open`: shows the code snippet by default
Modifier classes are used like this:
```
```html {.example .no-edit .open}
```
That will render an example without the CodePen button and with the code already shown.