doc/README.md
OniriCorpe 7a01793062
Improve markdown formatting of pages, a lot of them are improperly formatted (#2429)
* Revert "Revert "markdown format""

* fix formating

* fix readme

* add .markdownlint.json

* add markdownlint-rules-grav-pages

* add markdownlint-rules-grav-pages files

* add license for Markdown Lint Rules for Grav Pages

* fix [figure] mess

* fix [figure] mess 2

* fix [figure] mess 3

* maj .gitignore

* various fixes

* fix markdownlint-rules-grav-pages

* second formater pass

* various manual fixes

* add .markdownlintignore

* markdownlintignore: auto-generated pages

* disable proper-names for html_elements

* another bunch of various markdown fixes

* Update pages/02.administer/10.install/20.dns_config/dns_config.es.md

Co-authored-by: tituspijean <titus+yunohost@pijean.ovh>

---------

Co-authored-by: Alexandre Aubin <4533074+alexAubin@users.noreply.github.com>
Co-authored-by: tituspijean <titus+yunohost@pijean.ovh>
2024-03-23 08:59:52 +01:00

42 lines
1.1 KiB
Markdown

# YunoHost Documentation
- [Web Site](https://yunohost.org)
- Based on [Grav](https://getgrav.org/)
Please report [issues on YunoHost bugtracker](https://github.com/YunoHost/issues/issues).
## Note on package documentation
Package documentation should be done in the package repository itself, under the `/doc` folder.
You can learn about it here: <https://yunohost.org/packaging_app_doc>
## Contributing
This repo use a **submodule** to provide the theme. So when you clone use:
```bash
git clone --recursive https://github.com/YunoHost/doc.git
```
You can refer to the page on [writing documentation](https://yunohost.org/write_documentation).
If you know docker, you can run:
```bash
docker-compose up
```
### Regenerate the CSS
We use scss to manage the CSS. If you want to change it, you must rebuild it.
First install npm, then in the root folder of this repo, install sass: `npm install sass`
Finally you can rebuild the CSS with (You can replace `expanded` by `compressed` if you want):
```bash
./node_modules/sass/sass.js themes/yunohost-docs/scss:themes/yunohost-docs/css --style expanded
```
Source:
<https://sass-lang.com/guide>