Contributing
Working...
Working with MDX
Explanation of how to use MDX when adding your own or modifying existing lessons.
Author: Jaden Park

Incendium Academy uses MDX, a superset of Markdown, using the mdx-js compiler. HTML and React components are supported, so you can add them into your lessons.

For people new to Markdown syntax, here's a cheat sheet: Link

MetaData

MetaData is the stuff in the beginning of every lesson/module (title, description, and author'(s) names).

  • Title: Required

The title of the module/lesson.

  • Description: Required

A short description of the module/lesson.

  • Author: Required

The names of the authors who contributed.

Writing lessons

There are 2 ways to write lessons.

1. Using Obsidian, StackEdit, or other markdown renderers with LaTeX\LaTeX support

OR

2. Cloning the Github repository and running it on your machine locally.

My personal recommendation is Obsidian (if you're not familiar with Github and making PR's) as you might use it in the future for note taking for school or work. However, if you were to run it locally, follow these steps.

1. Set up your development environment.

2. Clone the repository.

  • Via command line: git clone [insert link to repo]

OR

3. Install the dependencies.

  • npm install

4. Run the development server.

  • npm run dev

If you have trouble with running the website locally, feel free to create an issue or pull request on our Github repo.