This project is built using Docusaurus 2, a modern static website generator. It also uses code snippets from https://github.com/supabase/supabase, copyright supabase 2020, licensed under the Apache 2.0 license.
If you're interested in contributing to either the documentation or the codebase itself then you are at the right place. This page is split up into 3 segments that are focused on getting you started with contributing:
- Minor Suggestions: changes to the contents of the pages, whether it be spelling mistakes, corrections or any other additional information. Requires a Github account.
- Major Suggestions: major changes to this website, starting from adding new pages, to changing the layout/styles and other HTML elements. Requires you to run a local version of the website.
- Build & Deploy: information on how to build and deploy this repository to a hosting solution.
At the end of each article the link "Edit this page" is displayed. Clicking on it will take you to the public Github repository of that particular page. From there on you can submit any of the changes you've made.
This website is built using the Docusaurus 2 framework, which is a modern static website generator. For any additional guidance to get the maximum out of the framework, please visit their website. Anyhow, the below contents should provide all sufficient information needed.
- You have to be on Node >= 8.x.
Clone this repo, and then run npm install
to install all dependencies. Populate and rename .sample.env
with Argola keys if you are interested in working with the search engine, else you can skip this step.
Run npm run start
. This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.
Use any of the .md files within the ~root/docs
section as an example/blueprint for your own page. Once you are ready edit the ~root/sidebars.js
file and add the subpage reference there. That's it.
Duplicate the ~root/src/pages/index.js
file and place it in the same directory, rename it however you like. That's it. Done! Your page is immediately accessible at http://localhost:3000/your_page
. For this basic knowledge of React.js is required.
If you have any suggestions to the documentation, feel free to contribute! This page is split up into two segments that are focused on getting you started with contributing:
- Minor Suggestions: changes to the contents of the pages, whether it be spelling mistakes, corrections or any other additional information. Requires a Github account.
- Major Suggestions: major changes to this website, starting from adding new pages, to changing the layout/styles and other HTML elements. Requires you to run a local version of the website.
At the end of each article the link "Edit this page" is displayed. Clicking on it will take you to the public Github repository of that particular page. From there on you can submit any of the changes you've made.
This website is built using the Docusaurus 2 framework, which is a modern static website generator. For any additional guidance to get the maximum out of the framework, please visit their website. Anyhow, the below contents should provide all sufficient information needed.
- You have to be on Node >= 8.x.
Clone this repo, and then run npm install
to install all dependencies. Populate and rename .sample.env
with Argola keys if you are interested in working with the search engine, else you can skip this step.
Run npm run start
. This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.
If you wish to learn more about build/dist and deployment to production please visit this website: https://v2.docusaurus.io/docs/deployment/ for specific information.
Use any of the .md files within the ~root/docs
section as an example/blueprint for your own page. Once you are ready edit the ~root/sidebars.js
file and add the subpage reference there. That's it.
Duplicate the ~root/src/pages/index.js
file and place it in the same directory, rename it however you like. That's it. Done! Your page is immediately accessible at http://localhost:3000/your_page
. In order to do this, basic knowledge of ReactJS is required.