So, you want to make your first post here! Read below the guidelines on how to make it happen!
1. Clone this Repo
Start by cloning locally this repo and create
a new branch from main
.
Make sure you have allowed signed commits (1)(2) on your account before pushing your new branch and opening a PR.
2. Conventions
- Use a
<!--
truncate
-->
comment to limit blog post size in the list view, respecting other's postings. - Add yourself to the
authors.yml
file if it is your first post (Welcome!). - Add a new folder with the following naming pattern:
YYYY-MM-DD-post-title
inside theblog/
folder. The blog post date can be extracted from filenames, such as:2019-05-30-welcome/index.mdx
- Inside it, create a new
index.mdx
- note that the name MUST be index.mdx and we are enforcing .mdx extensions throughout this project's posts. Read more below... - Images should be inserted inside your post's folder and inserted like this:
- Don't forget to use tags in the headings of your posts. This way we can sort content better for our readers (:
References
Blog posts support Docusaurus Markdown features, such as MDX.
tip
Use the power of React to create interactive blog posts. Don't abuse this feature!
<button onClick={() => alert('button clicked!')}>Click me!</button>
We have allowed the support to write TeX text inside postings for your convenience:
Let be Riemann integrable. Let be . Then is continuous, and at all such that is continuous at , is differentiable at with .
Please, check KaTeX documentations for more details.