https://github.com/geo-c/octdevcorner
Project-Documentation written in Markdown with MkDocs
https://github.com/geo-c/octdevcorner
documentation-tool mkdocs open-source python
Last synced: 2 months ago
JSON representation
Project-Documentation written in Markdown with MkDocs
- Host: GitHub
- URL: https://github.com/geo-c/octdevcorner
- Owner: geo-c
- License: mit
- Created: 2016-02-15T17:16:48.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2016-03-31T07:55:30.000Z (about 9 years ago)
- Last Synced: 2025-01-08T08:45:44.049Z (4 months ago)
- Topics: documentation-tool, mkdocs, open-source, python
- Homepage: http://giv-oct2.uni-muenster.de/dev-corner
- Size: 76.2 KB
- Stars: 0
- Watchers: 6
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dev-Corner
Documentation written with Mkdocs
***
### Build-process
* You need Python (2.7.2) and the Python Package Index (1.5.2) to build the documentation. Check if your operating-system provides it already:
```
python --version
pip --version
```
* This documentation uses [MkDocs](http://www.mkdocs.org/), so that the documentation can be written in Markdown. **Cheat cheets** for Markdown can be found here:
* [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)
* [https://daringfireball.net/projects/markdown/](https://daringfireball.net/projects/markdown/)
* Install MkDocs with the following command:
```
pip install mkdocs
```
* Clone this repository to your local-repository and build the documentation with the following command:
```
mkdocs build
```
**Attention**: If some problems occur during the build-process, you can also try to re-build the documentation with the following command:
```
mkdocs build --clean
```
* If you want to add new pages to this documenation, create a new `.md`-Files in folder: `docs/`
**Hint**: If you want to add sections, create a new folder, like this: `docs/NewSection` and create your new `.md`-files in this folder
* Before building, don't forget to add your new page(s) and sections in the `mkdocs.yml`-file. Please find an example at the end of this page: `NewSection` and `newSinglePage.md`
```
- Home: index.md
- Installations:
- Nodejs: installations/nodejs.md
- Bower: installations/bower.md
- Data:
- Collection: data/collection.md
- Storage: data/storage.md
- Retrieval: data/retrieval.md
- Analysis: data/analysis.md
- Visualization: data/visualization.md
- About:
- Licenses: about/licenses.md
- Repositories: about/repositories.md
- Contributers: about/contributers.md
- NewSection:
- newPage: newSection/newPage.md
- newSinglePage.md: newSinglePage.md
```
* Build the documentation with the command above (see: 4.). All `.md`-files will be generated into `.html`-files in the folder `site/`.
**Hint**: For automatically building, you can use the following command, to start the built-in-MkDocs-Server:
```
mkdocs serve
```
Open a new browser-tab and go to [http://127.0.0.1:8000/](http://127.0.0.1:8000/).
For more information about MkDocs, please have a look into their documentation [http://www.mkdocs.org/](http://www.mkdocs.org/)