Jekyll source for my notes on Programming Paradigms
To build offline, install Jekyll, then:
bundle exec jekyll serve
We use pre-commit to ensure quality and consistency of the markdown. To contribute, please follow these steps:
-
Install pre-commit:
pip install pre-commit
-
Install the pre-commit hooks:
pre-commit install
After this, the pre-commit hooks will run automatically on each commit to check for spelling and linting.
If you want to add solutions to your markdown files in this Jekyll site, you need to separate the solutions into a section. Ensure that your solutions are marked with a heading that is only the word "Solutions". This can be at any heading level (e.g., ### Solutions
, #### Solutions
). For example:
### Solutions
Your solution content goes here...
```javascript
const exampleFunction = () => {
console.log("This is an example solution");
};
## Rest of Document
Do not include any subheadings in solutions. The wrap_solution
plugin, will automatically process this and hide solutions by default, and will be toggleable on any relevant page.
To add an alert box:
<div class="alert-box alert-info" markdown="1">
This is an *important* bit of information!
</div>
Supported alert boxes are alert-info
, alert-warning
, and alert-danger
. To add a heading to the alert box, put the heading in strong emphasis/bold:
<div class="alert-box alert-info" markdown="1">
**Important Information**
This is an *important* bit of information!
</div>
The CSS styles will automatically add ‘💡 Note:’, ‘alert-info
, alert-warning
, and alert-danger
respectively) in front of the text in bold. Note that this means you cannot use bold text anywhere else in the info box at the moment.