Documentation for ScriptBlocks IDE.
Please feel free to contribute to our documentation! The format of our repository is very simple:
docs/
│
├── docs/
│ ├── en/ # English documentation
│ │ ├── index.md
│ │ └── ...
│ ├── es/ # Spanish documentation
│ │ ├── index.md
│ │ └── ...
│ └── fr/ # French documentation
│ ├── index.md
│ └── ...
│
├── mkdocs.yml
└── requirements.txt
docs/: The root directory for documentation files.en/: Contains the English version of the documentation.es/: Contains the Spanish version of the documentation.fr/: Contains the French version of the documentation.
mkdocs.yml: The configuration file for MkDocs, where you define site settings, themes, plugins, and translation options.requirements.txt: Lists Python dependencies for MkDocs and any additional plugins.
Feel free to contribute to our project if you would like to add more chapters, extend them, or if there are any mistranslations or inconsistencies. Here are the steps to contribute:
-
Clone the Repository
git clone https://github.com/ScriptBlocks/docs.git cd your-repo -
Install Dependencies
pip install -r requirements.txt
-
Add or Edit Documentation
- Navigate to the appropriate language directory (
en/,es/,fr/). - Edit or create Markdown files (
.md) as needed.
-
Test Locally
mkdocs serve
This command starts a local server at
http://127.0.0.1:8000where you can preview your changes. -
Submit a Pull Request
- Commit your changes and push to your fork.
- Open a pull request in the main repository.
- Translation Folders: The folder names for translations are based on their respective country codes (e.g.,
enfor English,esfor Spanish,frfor French). - MkDocs Configuration: The
mkdocs.ymlfile contains configuration settings, including theme choices, plugin settings, and translation configurations. Make sure to review and update this file as needed to reflect any structural changes.
Thank you for contributing to the ScriptBlocks IDE documentation!