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>

.gitignore

@@ -1,7 +1,9 @@
 /*
+!.github
 !/pages
 !/images
 !/themes
 !/Dockerfile
 !/docker-compose.yml
 !/dev/plugins
+!/markdownlint-rules-grav-pages

.markdownlint.json

@@ -0,0 +1,64 @@
+{
+    "extends": "markdownlint-rules-grav-pages/rules/frontmatter.schema.json",
+    "default": true,
+    "code-block-style": {
+        "style": "fenced"
+    },
+    "code-fence-style": {
+        "style": "backtick"
+    },
+    "emphasis-style": {
+        "style": "asterisk"
+    },
+    "strong-style": {
+        "style": "asterisk"
+    },
+    "ul-style": {
+        "style": "dash"
+    },
+    "ul-indent": {
+        "indent": 2
+    },
+    "heading-style": {
+        "style": "atx"
+    },
+    "no-duplicate-heading": {
+        "siblings_only": true
+    },
+    "hr-style": {
+        "style": "---"
+    },
+    "ol-prefix": {
+        "style": "ordered"
+    },
+    "no-trailing-punctuation": {
+        "punctuation": ".,;:"
+    },
+    "no-inline-html": false,
+    "fenced-code-language": {
+        "allowed_languages": [
+            "bash",
+            "html",
+            "css",
+            "javascript",
+            "php",
+            "json",
+            "yaml",
+            "toml",
+            "markdown",
+            "text"
+        ],
+        "language_only": true
+    },
+    "proper-names": {
+        "code_blocks": false,
+        "html_elements": false,
+        "names": [
+            "YunoHost",
+            "GitHub"
+        ]
+    },
+    "line-length": false,
+    "no-reversed-links": false,
+    "no-missing-space-atx": false
+}

.markdownlintignore

@@ -0,0 +1,11 @@
+config
+images
+tests
+themes
+.*
+Dockerfile
+docker-compose.yml
+
+# auto-generated pages
+pages/06.contribute/10.packaging_apps/80.resources/11.helpers/packaging_apps_helpers.md
+pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md

README.md

@@ -1,20 +1,20 @@
 # YunoHost Documentation
 
-* [Web Site](https://yunohost.org)
+- [Web Site](https://yunohost.org)
-* Based on [Grav](https://getgrav.org/)
+- Based on [Grav](https://getgrav.org/)
 
 Please report [issues on YunoHost bugtracker](https://github.com/YunoHost/issues/issues).
 
-## Note about package documentation
+## 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
+## Contributing
 
 This repo use a **submodule** to provide the theme. So when you clone use:
 
-```shell
+```bash
 git clone --recursive https://github.com/YunoHost/doc.git
 ```
 
@@ -22,11 +22,11 @@ You can refer to the page on [writing documentation](https://yunohost.org/write_
 
 If you know docker, you can run:
 
-```
+```bash
 docker-compose up
 ```
 
-## Regenerate the CSS
+### Regenerate the CSS
 
 We use scss to manage the CSS. If you want to change it, you must rebuild it.
 

markdownlint-rules-grav-pages/.eslintrc

@@ -0,0 +1,10 @@
+{
+  "extends": "airbnb-base",
+  "rules": {
+    "no-empty": ["error", { "allowEmptyCatch": true }],
+    "prefer-rest-params": "off",
+    "prefer-spread": "off",
+    "strict": "off",
+    "indent": ["error", 4]
+  }
+}

markdownlint-rules-grav-pages/.gitignore

@@ -0,0 +1,2 @@
+/node_modules/
+/.idea

markdownlint-rules-grav-pages/.travis.yml

@@ -0,0 +1,9 @@
+language: node_js
+node_js:
+  - "8"
+  - "9"
+  - "10"
+  - "11"
+script:
+  - npm run lint
+  - npm run test

markdownlint-rules-grav-pages/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [1.0.19](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.18...v1.0.19) (2022-05-18)
+
+### [1.0.18](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.17...v1.0.18) (2022-02-08)
+
+### [1.0.17](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.16...v1.0.17) (2022-02-03)
+
+### [1.0.16](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.15...v1.0.16) (2020-03-15)
+
+### [1.0.15](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.14...v1.0.15) (2019-12-30)
+
+### [1.0.14](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.13...v1.0.14) (2019-07-11)
+
+
+
+### [1.0.13](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.12...v1.0.13) (2019-05-10)
+
+
+
+<a name="1.0.12"></a>
+### [1.0.12](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.11...v1.0.12) (2019-02-14)
+
+
+
+<a name="1.0.11"></a>
+### [1.0.11](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.10...v1.0.11) (2018-12-04)
+
+
+
+<a name="1.0.10"></a>
+### [1.0.10](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.9...v1.0.10) (2018-10-23)
+
+
+
+<a name="1.0.9"></a>
+### [1.0.9](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.8...v1.0.9) (2018-10-03)
+
+
+
+<a name="1.0.8"></a>
+### [1.0.8](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.7...v1.0.8) (2018-09-14)
+
+
+
+<a name="1.0.7"></a>
+### [1.0.7](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.6...v1.0.7) (2018-08-28)
+
+
+
+<a name="1.0.6"></a>
+### [1.0.6](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.5...v1.0.6) (2018-08-28)
+
+
+
+<a name="1.0.5"></a>
+### [1.0.5](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.4...v1.0.5) (2018-08-20)
+
+
+
+<a name="1.0.4"></a>
+### [1.0.4](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.3...v1.0.4) (2018-08-09)
+
+
+
+<a name="1.0.3"></a>
+### [1.0.3](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.2...v1.0.3) (2018-08-09)
+
+
+
+<a name="1.0.2"></a>
+### [1.0.2](https://github.com/syseleven/markdownlint-rules-grav-pages/compare/v1.0.1...v1.0.2) (2018-07-30)
+
+
+
+<a name="1.0.1"></a>
+### 1.0.1 (2018-07-19)

markdownlint-rules-grav-pages/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2016, SysEleven GmbH
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the SysEleven GmbH nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL SYSELEVEN GMBH BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

markdownlint-rules-grav-pages/README.md

@@ -0,0 +1,44 @@
+# Markdown Lint Rules for Grav Pages
+
+[![Build Status](https://travis-ci.org/syseleven/markdownlint-rules-grav-pages.svg?branch=master)](https://travis-ci.org/syseleven/markdownlint-rules-grav-pages)
+
+This package contains additional linting rules for [markdownlint](https://github.com/DavidAnson/markdownlint)
+that check if a Markdown file is a valid [Grav CMS](https://getgrav.org/) page.
+
+## Rules
+
+### valid-images
+
+* Checks if a relatively referenced image is present.
+
+### valid-internal-links
+
+* Checks if a link to a another markdown file in the same repo is correct.
+
+### valid-metadata-block
+
+* Checks if a Frontmatter metadata block is present and valid.
+
+## Usage
+
+See https://github.com/DavidAnson/markdownlint/blob/master/doc/CustomRules.md
+
+## Development
+
+To lint all source files run:
+
+```bash
+$ npm run lint
+```
+
+To run all tests:
+
+```bash
+$ npm run test
+```
+
+To release a new version, ensure that the checkout is clean, then run:
+
+```bash
+$ npm run release && git push --follow-tags origin master && npm publish
+```

markdownlint-rules-grav-pages/lib/flat.js

@@ -0,0 +1,10 @@
+module.exports = function flat(array) {
+    let result = [];
+    array.forEach((a) => {
+        result.push(a);
+        if (Array.isArray(a.children)) {
+            result = result.concat(flat(a.children));
+        }
+    });
+    return result;
+};

markdownlint-rules-grav-pages/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "markdownlint-rules-grav-pages",
+  "version": "1.0.19",
+  "description": "Markdownlint rules for Grav Pages",
+  "license": "BSD-3-Clause",
+  "repository": "https://github.com/syseleven/markdownlint-rules-grav-pages",
+  "author": "Bastian Hofmann <b.hofmann@syseleven.de>",
+  "scripts": {
+    "lint": "eslint .",
+    "test": "jest tests",
+    "release": "standard-version"
+  },
+  "keywords": [
+    "markdownlint-rule"
+  ],
+  "husky": {
+    "hooks": {
+      "pre-commit": "npm run lint && npm run test"
+    }
+  },
+  "dependencies": {
+    "jsonschema": "^1.2.5",
+    "markdown-it": "^12.3.2",
+    "markdownlint": "^0.25.1",
+    "markdownlint-cli": "^0.31.1",
+    "transliteration": "^2.1.8",
+    "yamljs": "^0.3.0"
+  },
+  "devDependencies": {
+    "eslint": "^6.8.0",
+    "eslint-config-airbnb-base": "^14.1.0",
+    "eslint-plugin-import": "^2.20.1",
+    "husky": "^4.2.3",
+    "jest": "^28.1.0",
+    "standard-version": "^9.5.0"
+  },
+  "jest": {
+    "testEnvironmentOptions": {
+      "url": "http://localhost"
+    }
+  }
+}

markdownlint-rules-grav-pages/rules/frontmatter.schema.json

@@ -0,0 +1,119 @@
+{
+  "type": "object",
+  "properties": {
+    "title": { "type": "bool", "minLength": 2, "maxLength": 80 },
+    "media_order": { "type": "string" },
+    "body_classes": { "type": "string" },
+    "published": { "type": "boolean" },
+    "visible": { "type": "boolean" },
+    "redirect": { "type": "string" },
+    "cache_enable": { "type": "boolean" },
+    "debugger": { "type": "boolean" },
+    "never_cache_twig": { "type": "boolean" },
+    "twig_first": { "type": "boolean" },
+    "routable": { "type": "boolean" },
+    "login_redirect_here": { "type": "boolean" },
+    "last_modified": { "type": "boolean" },
+    "http_response_code": { "type": "integer" },
+    "lightbox": { "type": "boolean" },
+    "etag": { "type": "boolean" },
+    "template": { "type": "string" },
+    "template_format": { "type": "string" },
+    "date": { "type": "string" },
+    "publish_date": { "type": "string" },
+    "unpublish_date": { "type": "string" },
+    "expires": { "type": "integer" },
+    "menu": { "type": "string", "minLength": 2, "maxLength": 30 },
+    "slug": { "type": "string" },
+    "routes": {
+      "type": "object",
+      "properties": {
+        "default": { "type": "string" },
+        "canonical": { "type": "string" },
+        "aliases": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "taxonomy": {
+      "type": "object",
+      "properties": {
+        "category": { "type": "array", "items": { "type": "string" } },
+        "tag": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "external_url": { "type": "string" },
+    "external_links": {
+      "type": "object",
+      "properties": {
+        "target": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "author": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string" },
+        "twitter": { "type": "string" },
+        "bio": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "summary": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "format": { "type": "string" },
+        "size": { "type": "integer" }
+      },
+      "additionalProperties": false
+    },
+    "sitemap": {
+      "type": "object",
+      "properties": {
+        "changefreq": { "type": "string" },
+        "priority": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "process": {
+      "type": "object",
+      "properties": {
+        "markdown": { "type": "boolean" },
+        "twig": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "markdown": {
+      "type": "object",
+      "properties": {
+        "extra": { "type": "boolean" },
+        "auto_line_breaks": { "type": "boolean" },
+        "auto_url_links": { "type": "boolean" },
+        "escape_markup": { "type": "boolean" },
+        "special_chars": { "type": "object", "additionalProperties": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "refresh": { "type": "integer" }
+      },
+      "additionalProperties": { "type": "string" }
+    },
+    "page-toc": {
+      "type": "object",
+      "properties": {
+        "active": { "type": "boolean" },
+        "start": { "type": "integer" },
+        "depth": { "type": "integer" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "required": [
+    "title"
+  ]
+}

markdownlint-rules-grav-pages/rules/valid-images.js

@@ -0,0 +1,31 @@
+const fs = require('fs');
+const flat = require('../lib/flat');
+
+module.exports = {
+    names: ['valid-images'],
+    description: 'Rule that reports if a file has valid image references',
+    tags: ['test'],
+    function: function rule(params, onError) {
+        flat(params.tokens).filter((token) => token.type === 'image').forEach((image) => {
+            image.attrs.forEach((attr) => {
+                if (attr[0] === 'src') {
+                    let imgSrc = attr[1];
+                    if (!imgSrc.match(/^(https?:)/)) {
+                        if (imgSrc.includes('?')) {
+                            imgSrc = imgSrc.slice(0, imgSrc.indexOf('?'));
+                        }
+                        const path = `${params.name.split('/').slice(0, -1).join('/')}/${imgSrc}`;
+
+                        if (!fs.existsSync(path) || !fs.lstatSync(path).isFile()) {
+                            onError({
+                                lineNumber: image.lineNumber,
+                                detail: `Image src '${imgSrc}' does not link to a valid file.`,
+                                context: image.line,
+                            });
+                        }
+                    }
+                }
+            });
+        });
+    },
+};

markdownlint-rules-grav-pages/rules/valid-internal-links.js

@@ -0,0 +1,128 @@
+const transliteration = require('transliteration');
+const fs = require('fs');
+const url = require('url');
+const md = require('markdown-it')({ html: true });
+const helpers = require('markdownlint/helpers/helpers');
+const flat = require('../lib/flat');
+
+const validateAnchor = (link, href, tokens, onError) => {
+    let anchorFound = false;
+    tokens.filter((token) => token.type === 'heading_open').forEach((heading) => {
+        if (!heading.line) {
+            return;
+        }
+
+        const headingAnchor = transliteration.slugify(heading.line.toLowerCase(), {
+            replace: {
+                ä: 'ae',
+                ö: 'oe',
+                ü: 'ue',
+            },
+        });
+
+        if (`#${headingAnchor}` === href) {
+            anchorFound = true;
+        }
+    });
+    if (!anchorFound) {
+        onError({
+            lineNumber: link.lineNumber,
+            detail: `Did not find matching heading for anchor '${href}'`,
+            context: link.line,
+        });
+    }
+};
+
+// Annotate tokens with line/lineNumber, duplication from markdownlint because function
+// is not exposed
+const annotateTokens = (tokens, lines) => {
+    let tbodyMap = null;
+    return tokens.map((token) => {
+        // Handle missing maps for table body
+        if (token.type === 'tbody_open') {
+            tbodyMap = token.map.slice();
+        } else if ((token.type === 'tr_close') && tbodyMap) {
+            tbodyMap[0] += 1;
+        } else if (token.type === 'tbody_close') {
+            tbodyMap = null;
+        }
+        const mappedToken = token;
+        if (tbodyMap && !token.map) {
+            mappedToken.map = tbodyMap.slice();
+        }
+        // Update token metadata
+        if (token.map) {
+            mappedToken.line = lines[token.map[0]];
+            mappedToken.lineNumber = token.map[0] + 1;
+            // Trim bottom of token to exclude whitespace lines
+            while (token.map[1] && !(lines[token.map[1] - 1].trim())) {
+                mappedToken.map[1] -= 1;
+            }
+            // Annotate children with lineNumber
+            let childLineNumber = token.lineNumber;
+            (token.children || []).map((child) => {
+                const mappedChild = child;
+                mappedChild.lineNumber = childLineNumber;
+                mappedChild.line = lines[childLineNumber - 1];
+                if ((child.type === 'softbreak') || (child.type === 'hardbreak')) {
+                    childLineNumber += 1;
+                }
+                return mappedChild;
+            });
+        }
+
+        return mappedToken;
+    });
+};
+
+const parseMarkdownContent = (fileContent) => {
+    // Remove UTF-8 byte order marker (if present)
+    let content = fileContent.replace(/^\ufeff/, '');
+    // Ignore the content of HTML comments
+    content = helpers.clearHtmlCommentText(content);
+    // Parse content into tokens and lines
+    const tokens = md.parse(content, {});
+    const lines = content.split(helpers.newLineRe);
+    return annotateTokens(tokens, lines);
+};
+
+module.exports = {
+    names: ['valid-internal-links'],
+    description: 'Rule that reports if a file has an internal link to an invalid file',
+    tags: ['test'],
+    function: function rule(params, onError) {
+        flat(params.tokens).filter((token) => token.type === 'link_open').forEach((link) => {
+            link.attrs.forEach((attr) => {
+                if (attr[0] === 'href') {
+                    const href = attr[1];
+                    if (href.match(/^#/)) {
+                        validateAnchor(link, href, params.tokens, onError);
+                    } else if (href && !href.match(/^(mailto:|https?:)/)) {
+                        const parsedHref = url.parse(href);
+                        let path;
+                        if (parsedHref.pathname.match(/^\//)) {
+                            path = `pages${parsedHref.pathname}`;
+                        } else {
+                            path = `${params.name.split('/').slice(0, -1).join('/')}/${parsedHref.pathname}`;
+                        }
+                        if (!fs.existsSync(path) || !fs.lstatSync(path).isFile()) {
+                            onError({
+                                lineNumber: link.lineNumber,
+                                detail: `Relative link '${href}' does not link to a valid file.`,
+                                context: link.line,
+                            });
+                        } else if (parsedHref.hash) {
+                            // console.log(md.parse(fs.readFileSync(path).toString()));
+                            validateAnchor(
+                                link,
+                                parsedHref.hash,
+                                parseMarkdownContent(fs.readFileSync(path).toString()),
+                                onError,
+                            );
+                        }
+                    }
+                }
+            });
+        });
+    },
+};

markdownlint-rules-grav-pages/rules/valid-metadata-block.js

@@ -0,0 +1,69 @@
+const YAML = require('yamljs');
+const { Validator } = require('jsonschema');
+// See https://learn.getgrav.org/content/headers
+const metadataSchema = require('./frontmatter.schema.json');
+
+module.exports = {
+    names: ['valid-metadata-block'],
+    description: 'Rule that reports if a file does not have a valid grav metadata block',
+    tags: ['test'],
+    function: function rule(params, onError) {
+        if (!params.frontMatterLines || params.frontMatterLines.length < 3) {
+            onError({
+                lineNumber: 1,
+                detail: 'Missing grav metadata block',
+            });
+            return;
+        }
+        const frontMatterLines = params.frontMatterLines.filter((line) => !!line);
+        if (frontMatterLines[0] !== '---') {
+            onError({
+                lineNumber: 1,
+                detail: "Grav metadata block has to start with a '---'",
+                context: frontMatterLines[0],
+            });
+            return;
+        }
+        if (frontMatterLines[frontMatterLines.length - 1] !== '---') {
+            onError({
+                lineNumber: 1,
+                detail: "Grav metadata block has to end with a '---'",
+                context: frontMatterLines[frontMatterLines.length - 1],
+            });
+            return;
+        }
+        const yamlString = frontMatterLines.slice(1, -1).join('\n');
+        let yamlDocument;
+        try {
+            yamlDocument = YAML.parse(yamlString);
+        } catch (err) {
+            onError({
+                lineNumber: 1,
+                detail: 'Error parsing grav metadata block',
+                context: err.toString(),
+            });
+            return;
+        }
+
+        if (!yamlDocument) {
+            onError({
+                lineNumber: 1,
+                detail: 'Grav metadata is not a valid yaml document',
+                context: yamlString,
+            });
+            return;
+        }
+
+        const v = new Validator();
+
+        const validation = v.validate(yamlDocument, metadataSchema);
+
+        validation.errors.forEach((validationError) => {
+            onError({
+                lineNumber: 1,
+                detail: validationError.toString(),
+                context: yamlString,
+            });
+        });
+    },
+};

markdownlint-rules-grav-pages/tests/.eslintrc

@@ -0,0 +1,9 @@
+{
+  "globals": {
+    "test": true,
+    "expect": true,
+    "describe": true,
+    "beforeEach": true,
+    "afterEach": true
+  }
+}

markdownlint-rules-grav-pages/tests/assets/valid-images/test.md

@@ -0,0 +1,23 @@
+# Valid Images Test
+
+Valid image
+
+![AltText](test.image)
+
+Valid relative image
+
+![AltText](../test.image)
+
+Invalid image
+
+![AltText](test.invalid)
+
+Invalid relative image
+
+![AltText](../invalid/test.image)
+
+## Valid External Anchor
+
+Valid image with modifying grav query
+
+![AltText](test.image?resize=100,100)

markdownlint-rules-grav-pages/tests/assets/valid-internal-links/test.md

@@ -0,0 +1,46 @@
+# Valid Internal Links Test
+
+Valid path
+
+[Text](test.md)
+
+Valid relative path
+
+[Text](../valid-images/test.md)
+
+Invalid path
+
+[Text](test.invalid)
+
+Valid relative path
+
+[Text](../valid-images/invalid.md)
+
+No file
+
+[Text](../valid-images)
+
+As child: valid [Text](test.md) invalid [Text](test.invalid)
+
+[Anchor](#valid-anchor)
+[Anchor](#invalid-anchor)
+
+## Valid Anchor
+
+Valid relative path with anchor
+
+[Text](../valid-images/test.md#valid-external-anchor)
+
+Valid relative path with invalid anchor
+
+[Text](../valid-images/test.md#invalid-external-anchor)
+
+## Anchor with question?
+
+[Anchor](#anchor-with-question)
+
+## Anchor with umlaut üÜß
+
+[Anchor](#anchor-with-umlaut-ueuess)
+
+[LinkWithoutSrc]()

markdownlint-rules-grav-pages/tests/assets/valid-metadata-block/invalid-too-long-title.md

@@ -0,0 +1,5 @@
+---
+title: VeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitle
+---
+
+## Content

markdownlint-rules-grav-pages/tests/assets/valid-metadata-block/invalid-unrecognized-property.md

@@ -0,0 +1,6 @@
+---
+title: My Page
+invalid: field
+---
+
+## Content

markdownlint-rules-grav-pages/tests/assets/valid-metadata-block/valid-minimum-block.md

@@ -0,0 +1,5 @@
+---
+title: My Page
+---
+
+## Content

markdownlint-rules-grav-pages/tests/assets/valid-metadata-block/valid-taxonomy.md

@@ -0,0 +1,11 @@
+---
+title: My Page
+taxonomy:
+    category:
+        - one
+        - two
+    tag:
+        - tag
+---
+
+## Content

markdownlint-rules-grav-pages/tests/valid-images.spec.js

@@ -0,0 +1,31 @@
+const markdownlint = require('markdownlint');
+const validImagesRule = require('../rules/valid-images');
+
+test('validate images', () => {
+    const src = `${__dirname}/assets/valid-images/test.md`;
+    const results = markdownlint.sync({
+        customRules: validImagesRule,
+        files: [src],
+    });
+
+    expect(results[src]).toEqual([
+        {
+            lineNumber: 13,
+            ruleNames: ['valid-images'],
+            ruleDescription: 'Rule that reports if a file has valid image references',
+            ruleInformation: null,
+            errorDetail: 'Image src \'test.invalid\' does not link to a valid file.',
+            errorContext: '![AltText](test.invalid)',
+            errorRange: null,
+        },
+        {
+            lineNumber: 17,
+            ruleNames: ['valid-images'],
+            ruleDescription: 'Rule that reports if a file has valid image references',
+            ruleInformation: null,
+            errorDetail: 'Image src \'../invalid/test.image\' does not link to a valid file.',
+            errorContext: '![AltText](../invalid/test.image)',
+            errorRange: null,
+        },
+    ]);
+});

markdownlint-rules-grav-pages/tests/valid-internal-links.spec.js

@@ -0,0 +1,89 @@
+const markdownlint = require('markdownlint');
+const validInternalLinks = require('../rules/valid-internal-links');
+
+test('validate internal link', () => {
+    const src = `${__dirname}/assets/valid-internal-links/test.md`;
+    const results = markdownlint.sync({
+        customRules: validInternalLinks,
+        files: [src],
+        config: {
+            default: true,
+            'no-trailing-punctuation': {
+                punctuation: '.,;:!',
+            },
+        },
+    });
+
+    expect(results[src]).toEqual([
+        {
+            errorContext: '[LinkWithoutSrc]()',
+            errorDetail: null,
+            errorRange: [1, 18],
+            lineNumber: 46,
+            ruleDescription: 'No empty links',
+            ruleInformation: 'https://github.com/DavidAnson/markdownlint/blob/v0.25.1/doc/Rules.md#md042',
+            ruleNames: [
+                'MD042',
+                'no-empty-links',
+            ],
+        },
+        {
+            lineNumber: 13,
+            ruleNames: ['valid-internal-links'],
+            ruleDescription: 'Rule that reports if a file has an internal link to an invalid file',
+            ruleInformation: null,
+            errorDetail: 'Relative link \'test.invalid\' does not link to a valid file.',
+            errorContext: '[Text](test.invalid)',
+            errorRange: null,
+        },
+        {
+            lineNumber: 17,
+            ruleNames: ['valid-internal-links'],
+            ruleDescription: 'Rule that reports if a file has an internal link to an invalid file',
+            ruleInformation: null,
+            errorDetail: 'Relative link \'../valid-images/invalid.md\' does not link to a valid file.',
+            errorContext: '[Text](../valid-images/invalid.md)',
+            errorRange: null,
+        },
+        {
+            lineNumber: 21,
+            ruleNames: ['valid-internal-links'],
+            ruleDescription: 'Rule that reports if a file has an internal link to an invalid file',
+            ruleInformation: null,
+            errorDetail: 'Relative link \'../valid-images\' does not link to a valid file.',
+            errorContext: '[Text](../valid-images)',
+            errorRange: null,
+        },
+        {
+            lineNumber: 23,
+            ruleNames: ['valid-internal-links'],
+            ruleDescription: 'Rule that reports if a file has an internal link to an invalid file',
+            ruleInformation: null,
+            errorDetail: 'Relative link \'test.invalid\' does not link to a valid file.',
+            errorContext: 'As child: valid [Text](test.md) invalid [Text](test.invalid)',
+            errorRange: null,
+        },
+        {
+            errorContext: '[Anchor](#invalid-anchor)',
+            errorDetail: "Did not find matching heading for anchor '#invalid-anchor'",
+            errorRange: null,
+            lineNumber: 26,
+            ruleDescription: 'Rule that reports if a file has an internal link to an invalid file',
+            ruleInformation: null,
+            ruleNames: [
+                'valid-internal-links',
+            ],
+        },
+        {
+            errorContext: '[Text](../valid-images/test.md#invalid-external-anchor)',
+            errorDetail: "Did not find matching heading for anchor '#invalid-external-anchor'",
+            errorRange: null,
+            lineNumber: 36,
+            ruleDescription: 'Rule that reports if a file has an internal link to an invalid file',
+            ruleInformation: null,
+            ruleNames: [
+                'valid-internal-links',
+            ],
+        },
+    ]);
+});

markdownlint-rules-grav-pages/tests/valid-metadata-block.spec.js

@@ -0,0 +1,60 @@
+const markdownlint = require('markdownlint');
+const validMetadataBlockRule = require('../rules/valid-metadata-block');
+
+// TODO add more test cases
+
+test('validate valid minimum block', () => {
+    const src = `${__dirname}/assets/valid-metadata-block/valid-minimum-block.md`;
+    const results = markdownlint.sync({
+        customRules: validMetadataBlockRule,
+        files: [src],
+    });
+
+    expect(results[src]).toEqual([]);
+});
+
+test('validate too long title', () => {
+    const src = `${__dirname}/assets/valid-metadata-block/invalid-too-long-title.md`;
+    const results = markdownlint.sync({
+        customRules: validMetadataBlockRule,
+        files: [src],
+    });
+
+    expect(results[src]).toEqual([{
+        errorContext: 'title: VeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitleVeryLongTitle',
+        errorDetail: 'instance.title does not meet maximum length of 80',
+        errorRange: null,
+        lineNumber: 5,
+        ruleDescription: 'Rule that reports if a file does not have a valid grav metadata block',
+        ruleInformation: null,
+        ruleNames: ['valid-metadata-block'],
+    }]);
+});
+
+test('validate unrecognized property', () => {
+    const src = `${__dirname}/assets/valid-metadata-block/invalid-unrecognized-property.md`;
+    const results = markdownlint.sync({
+        customRules: validMetadataBlockRule,
+        files: [src],
+    });
+
+    expect(results[src]).toEqual([{
+        errorContext: 'title: My Page\ninvalid: field',
+        errorDetail: 'instance additionalProperty "invalid" exists in instance when not allowed',
+        errorRange: null,
+        lineNumber: 6,
+        ruleDescription: 'Rule that reports if a file does not have a valid grav metadata block',
+        ruleInformation: null,
+        ruleNames: ['valid-metadata-block'],
+    }]);
+});
+
+test('validate valid taxonomy', () => {
+    const src = `${__dirname}/assets/valid-metadata-block/valid-taxonomy.md`;
+    const results = markdownlint.sync({
+        customRules: validMetadataBlockRule,
+        files: [src],
+    });
+
+    expect(results[src]).toEqual([]);
+});

orphaned/default.es.md

@@ -2,10 +2,10 @@
 
 Esta página todavía no existe, puedes editarla tecleando ```<Escap>``` en tu teclado, o clicando en el botón "Editar" abajo a la derecha de tu pantalla. Puedes echar un vistazo a los cambios que has efectuado empujando de nuevo la tecla ```<Escap>``` o clicando en el botón "Vistazo".
 
-** Nota : ** Necesitarás una dirección email para validar tu propuesta.
+**Nota :** Necesitarás una dirección email para validar tu propuesta.
 
+## Sintaxis
 
-### Sintaxis
 Esta página utiliza la sintaxis Markdown, refiérete a la documentación para más informaciones :
 
-http://daringfireball.net/projects/markdown/syntax
+<http://daringfireball.net/projects/markdown/syntax>

orphaned/default.fr.md

@@ -2,10 +2,10 @@
 
 Cette page n’existe pas encore, vous pouvez l’éditer en appuyant sur la touche ```<Échap>``` de votre clavier, ou en cliquant sur le bouton "Éditer" en bas à droite de votre écran. Vous pourrez avoir un aperçu de vos changements en appuyant à nouveau sur la touche ```<Échap>``` ou en cliquant sur le bouton "Aperçu".
 
-** Note : ** Vous aurez besoin d'une adresse email pour valider votre proposition.
+**Note :** Vous aurez besoin d'une adresse email pour valider votre proposition.
 
+## Syntaxe
 
-### Syntaxe
 Cette page utilise la syntaxe Markdown, veuillez vous référer à la documentation pour plus d’informations :
 
-http://daringfireball.net/projects/markdown/syntax
+<http://daringfireball.net/projects/markdown/syntax>

orphaned/default.it.md

@@ -2,10 +2,10 @@
 
 Questa pagina non è ancora stata creata, puoi modificarla premendo ```<ESC>``` sulla tua tastiera o cliccando il pulsante "Modifica" in basso a destra del tuo schermo. Potrai vedere l'anteprima delle tue modifiche premendo ancora ```<ESC>``` o cliccando il pulsante "Anteprima".
 
-** Nota: ** Devi fornire un indirizzo email per confermare le tue modifiche.
+**Nota:** Devi fornire un indirizzo email per confermare le tue modifiche.
 
-### Sintassi
+## Sintassi
 
 Questa pagina usa la sintassi markdown, per favore fai riferimento alla documentazione per ulteriori informazioni:
 
-http://daringfireball.net/projects/markdown/syntax
+<http://daringfireball.net/projects/markdown/syntax>

orphaned/default.md

@@ -2,10 +2,10 @@
 
 This page is not created yet, you can edit it by pressing ```<ESC>``` on your keyboard or by clicking the "edit" button on the bottom-right side of your screen. You will be able to preview your changes by pressing ```<ESC>``` again or by clicking the "preview" button.
 
-** Note: ** You will need to provide an email address to validate your submission.
+**Note:** You will need to provide an email address to validate your submission.
 
-### Syntax
+## Syntax
 
 This page use the markdown syntax, please refer to the documentation for further informations:
 
-http://daringfireball.net/projects/markdown/syntax
+<http://daringfireball.net/projects/markdown/syntax>

orphaned/dns.es.md

@@ -20,7 +20,6 @@ También existen **tipos** de registros DNS, lo que significa que un dominio pue
 
 **Por ejemplo** : `www.yunohost.org` apunta hacia `yunohost.org`
 
-
 ### ¿ Cómo (bien) hacer la configuración ?
 
 Tienes varias opciones. Nota que puedes cumular estas soluciones si posees varios dominios : por ejemplo, puedes tener `mi-servidor.nohost.me` utilizando la solución **1.**, et `mi-servidor.org` utilizando la solución **2.**, redirigiéndolos hacia el mismo servidor YunoHost.

orphaned/dns.fr.md

@@ -8,7 +8,7 @@ La configuration des DNS est une étape cruciale pour que votre serveur soit acc
 
 **N’hésitez pas à regarder la très bonne conférence de Stéphane Bortzmeyer :**
 
-https://www.iletaitunefoisinternet.fr/post/1-dns-bortzmeyer/
+<https://www.iletaitunefoisinternet.fr/post/1-dns-bortzmeyer/>
 
 DNS signifie « Domain Name Server » en anglais, et est souvent employé pour désigner la configuration de vos noms de domaine. Vos noms de domaines doivent en effet pointer vers quelque chose (en général une adresse IP).
 
@@ -23,7 +23,6 @@ Il existe également des **types** d’enregistrement DNS, ce qui veut dire qu
 
 **Par exemple** : `www.yunohost.org` renvoie vers `yunohost.org`
 
-
 ### Comment (bien) faire la configuration ?
 
 Plusieurs choix s’offrent à vous. Notez que vous pouvez cumuler ces solutions si vous possédez plusieurs domaines : par exemple vous pouvez avoir `mon-serveur.nohost.me` en utilisant la solution **1.**, et `mon-serveur.org` en utilisant la solution **2.**, redirigeant vers le même serveur YunoHost.

orphaned/dns.md

@@ -34,5 +34,3 @@ You can also check out these pages for specific [registrar](/registrar) document
 3. (Advanced, not 100% supported...) Your YunoHost instance has its own DNS service, which means it will automatically configure its own DNS records, and that you can leave the setup to the instance itself. To do this, you must explain to your **registrar** that your YunoHost instance is the authoritative DNS server for your domain name.
 
   **Warning**: If you choose this option, all configuration options will be done automatically, you will retain a good deal of flexibility, but if your server gets knocked offline you will run into many problems. **Choose this only if you understand the implications.**
-
-

orphaned/index.ar.md

@@ -107,7 +107,6 @@
   <div dir="auto" class="text-center">
     <h1>تذكروا ! نحن بشر !<br /><small> إن كان عندكم تساؤل أو واجهتكم مشكلة أو ربما يهمُّكُم المشروع فقط، انضموا إلينا عبر غرفة المحادثة الخاصة بنا لتبليغنا التحية بالنقر على الزر أدناه &nbsp;<span class="glyphicon glyphicon-share-alt"></span> </small></h1>
 
-
 <p class="liberapay">
       <a href="https://liberapay.com/YunoHost" target="_blank"><img src="/images/liberapay_logo.svg" alt="Donation button" title="Liberapay" /></a>
     </p>
@@ -136,7 +135,6 @@
     </div>
   </div>
 
-
 </div><!-- boring-part -->
 
 <script type="text/javascript">

orphaned/index.de.md

@@ -135,7 +135,6 @@ Self-Hosting für alle ermöglicht.</small></h1>
     </div>
   </div>
 
-
 </div><!-- boring-part -->
 
 <script type="text/javascript">
@@ -171,4 +170,3 @@ Self-Hosting für alle ermöglicht.</small></h1>
     });
 
 </script>
-

orphaned/index.es.md

@@ -134,7 +134,6 @@
     </div>
   </div>
 
-
 </div><!-- boring-part -->
 
 <script type="text/javascript">

orphaned/index.fr.md

@@ -118,7 +118,6 @@
     </div>
   </div>
 
-
 </div><!-- boring-part -->
 
 <script type="text/javascript">
@@ -154,4 +153,3 @@
     });
 
 </script>
-

orphaned/index.it.md

@@ -135,7 +135,6 @@
     </div>
   </div>
 
-
 </div><!-- boring-part -->
 
 <script type="text/javascript">
@@ -171,4 +170,3 @@
     });
 
 </script>
-

orphaned/index.md

@@ -44,7 +44,6 @@
     <h2 style="margin-top: 0"><small><a href="https://forum.yunohost.org/c/announcement">Latest news</a></small></h2>
   </div>
 
-
   <div class="row cf">
     <div class="col-md-7 text-right">
       <h1>Setup <small>your server with ease, you already have everything at home</small></h1>

orphaned/index.oc.md

@@ -133,7 +133,6 @@
     </div>
   </div>
 
-
 </div><!-- boring-part -->
 
 <script type="text/javascript">
@@ -169,4 +168,3 @@
     });
 
 </script>
-

orphaned/registrar.fr.md

@@ -1,8 +1,9 @@
 # Bureaux d’enregistrement
 
 Voici une liste des bureaux d’enregistrement pour acheter un nom de domaine :
-* [OVH](http://ovh.com/)
+
-* [Gandi](http://gandi.net/)
+- [OVH](http://ovh.com/)
-* [Namecheap](https://www.namecheap.com/)
+- [Gandi](http://gandi.net/)
-* [BookMyName](https://www.bookmyname.com/)
+- [Namecheap](https://www.namecheap.com/)
-* [GoDaddy](https://godaddy.com/) /!\ GoDaddy [n'est pas un bon exemple pour la censure](https://en.wikipedia.org/wiki/GoDaddy#Controversies)
+- [BookMyName](https://www.bookmyname.com/)
+- [GoDaddy](https://godaddy.com/) /!\ GoDaddy [n'est pas un bon exemple pour la censure](https://en.wikipedia.org/wiki/GoDaddy#Controversies)

orphaned/registrar.md

@@ -1,8 +1,9 @@
 # Registar
 
 Here is a list of Registrars to book domain names:
-* [OVH](http://ovh.com/)
+
-* [Gandi](http://gandi.net/)
+- [OVH](http://ovh.com/)
-* [Namecheap](https://www.namecheap.com/)
+- [Gandi](http://gandi.net/)
-* [BookMyName](https://www.bookmyname.com/)
+- [Namecheap](https://www.namecheap.com/)
-* [GoDaddy](https://godaddy.com/) /!\ GoDaddy is [not a good example about censorship](https://en.wikipedia.org/wiki/GoDaddy#Controversies)
+- [BookMyName](https://www.bookmyname.com/)
+- [GoDaddy](https://godaddy.com/) /!\ GoDaddy is [not a good example about censorship](https://en.wikipedia.org/wiki/GoDaddy#Controversies)

pages/00.home/docs.de.md

@@ -16,7 +16,6 @@ Weitere Informationen zum Selbsthosting, zur Installation deines eigenen YunoHos
 
 Du kannst in den [Anwendungskatalog](/apps) schauen, um die Apps anzusehen, die auf deinem Server installiert werden können (Natürlich geht das auch direkt über deine Administrationsoberfläche!).
 
-
 Wenn du Hilfe benötigst, ist die [Community](/community) für dich da: [Chatte](/chat_rooms) mit uns oder schau in das [Forum](/community/forum)!
 
 [center]
@@ -28,7 +27,6 @@ Wenn du Hilfe benötigst, ist die [Community](/community) für dich da: [Chatte]
 
 [/center]
 
-
 [center]
 <a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Zurück zur Homepage</a>
 [/center]

pages/00.home/docs.es.md

@@ -27,7 +27,6 @@ La [Comunidad](/community) esta disponible para ayudarte : entra en el [chat](/c
 
 [/center]
 
-
 [center]
 <a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Volver a la página principal</a>
 [/center]

pages/00.home/docs.fr.md

@@ -31,5 +31,4 @@ La [communauté](/community) est là si vous avez besoin d'aide : venez discuter
 <a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Retourner à la page d'accueil du site</a>
 [/center]
 
-
 !!!! Pour naviguer dans cette documentation, vous pouvez utiliser les flèches gauches et droites. Utilisez le [fa=bars /] panneau latéral pour aller directement dans les sections qui vous intéresse ou en utilisant la [fa=search /] barre de recherche. Enjoy!

pages/00.home/docs.it.md

@@ -30,4 +30,3 @@ La [comunità](/community) è disponibile se avete bisogno di aiuto: potete veni
 [/center]
 
 !!!! Per navigare in questa documentazione potete utilizzare i tasti freccia destra e sinistra. Navigate direttamente nella sezione che vi interessa con il [fa=bars /] pannello laterale o utilizzate il [fa=search /] box di ricerca. Enjoy!
-

pages/00.home/docs.md

@@ -27,7 +27,6 @@ The [Community](/community) is here for you if you need some help : come [chat](
 
 [/center]
 
-
 [center]
 <a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Go back to the homepage</a>
 [/center]

pages/00.home/docs.ru.md

@@ -27,7 +27,6 @@ visible: false
 
 [/center]
 
-
 [center]
 <a href="/" class="btn btn-lg inline"><i class="fa fa-fw fa-arrow-left"></i> Вернуться на главную</a>
 [/center]

pages/01.overview/05.self_hosting/self_hosting.de.md

@@ -18,7 +18,7 @@ Beim Self-Hosting geht es nicht darum, "Ihr Internet" sicherer zu machen, und es
 
 - **Sie glauben an ein freies, offenes und dezentrales Internet.** In einem zentralisierten Internet können private Unternehmen und Behörden Personen ausspähen, analysieren und beeinflussen, indem sie diktieren, wie Sie sich miteinander verbinden, und indem sie Inhalte filtern. YunoHost wird von einer Community entwickelt, die an ein offenes und dezentrales Internet glaubt, und wir hoffen, dass Sie dies auch tun!
 
-- **Sie möchten die Kontrolle über Ihre Daten und Dienste haben.** Ihre Bilder, Chatnachrichten, der Browserverlauf und der Text, den Sie für die Schule schreiben, haben auf dem Server eines anderen Benutzers (a.k.a. The Cloud) nichts zu suchen. Sie sind Teil Ihres Privatlebens, aber auch Teil des Lebens Ihrer Familie, Ihres Partners und so weiter. Diese Daten sollten von * Ihnen * verwaltet werden, nicht von einem zufälligen Unternehmen in den USA, dass Ihre Daten analysieren und die Ergebnisse verkaufen möchte.
+- **Sie möchten die Kontrolle über Ihre Daten und Dienste haben.** Ihre Bilder, Chatnachrichten, der Browserverlauf und der Text, den Sie für die Schule schreiben, haben auf dem Server eines anderen Benutzers (a.k.a. The Cloud) nichts zu suchen. Sie sind Teil Ihres Privatlebens, aber auch Teil des Lebens Ihrer Familie, Ihres Partners und so weiter. Diese Daten sollten von *Ihnen* verwaltet werden, nicht von einem zufälligen Unternehmen in den USA, dass Ihre Daten analysieren und die Ergebnisse verkaufen möchte.
 
 - **Sie möchten lernen, wie Computer und das Internet funktionieren.** Der Betrieb eines eigenen Servers ist ein guter Kontext, um die grundlegenden Mechanismen von Betriebssystemen und dem Internet zu verstehen. Möglicherweise müssen Sie sich mit der Befehlszeilenschnittstelle, der Netzwerkarchitektur, der DNS-Konfiguration und mit SSH usw. befassen.
 

pages/01.overview/05.self_hosting/self_hosting.es.md

@@ -6,59 +6,28 @@ taxonomy:
 routes:
   default: '/selfhosting'
 ---
-<!--
+
-L'auto-hébergement est le fait d'avoir et d'administrer son propre serveur, typiquement chez soi, pour héberger soi-même ses données personnelles et des services plutôt que de se reposer exclusivement sur des tiers. Par exemple, il est possible d'auto-héberger son blog de sorte qu'il "vive" dans une machine que vous contrôlez, au lieu qu'il soit sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud) en échange d'argent, de publicités ou de données privées.
--->
 
 El auto-alojamiento se refiere al hecho de tener y administrar tú tu propio servidor, normalmente en tu casa, para hospedar tus datos personales y servicios, en lugar de depender de terceros. Por ejemplo, es posible el auto-hospedaje de tu blog, de manera que este "viva" dentro de una máquina que controlas, en lugar de que se aloje en un ordenador de otra persona/empresa (alias La Nube) contra dinero, publicidad o cesión de datos privados.
 
-<!--
-L'auto-hébergement implique de disposer d'un serveur. Un serveur est un ordinateur qui est destiné à être accessible sur le réseau en permanence, et n'a généralement pas d'écran ni de clavier puisqu'il est administré à distance. Contrairement à une croyance répandue, les serveurs ne sont pas nécessairement des machines énormes et extrêmement puissantes : aujourd'hui, une petite carte ARM à ~30€ est adéquate pour de l'auto-hébergement.
--->
-
 Auto-alojar implica disponer de un servidor. Un servidor es un ordenador destinado a ser accesible en la red las 24 horas del día y que normalmente no tiene ni pantalla ni teclado, ya que se controla a distancia. Contrariamente a una creencia extendida, los servidores no son necesariamente máquinas enormes y muy potentes: en la actualidad, una pequeña placa ARM de unos ~30€/$ es suficiente para el auto-hospedaje.
-<!--
-Pratiquer l'auto-hébergement ne rend pas "votre internet" plus sécurisé et ne fournit pas d'anonymat en tant que tel. L'objectif est généralement de pouvoir être autonome et au contrôle de ses services et de ses données - ce qui implique aussi d'en être responsable.
--->
 
 La práctica del auto-alojamiento no convierte "tu internet" más segura y tampoco proporciona anonimato por si mismo. El objetivo es generalmente generar autonomía y control de tus servicios y tus datos - lo que también implica una responsabilidad.
 
 ## ¿Cuáles son los beneficios del auto-alojamiento?
 
-<!-- 
-- **Vous croyez en un internet libre, ouvert et décentralisé.** Dans un internet centralisé, les entités privées et les gouvernements peuvent espionner, analyser et influencer les personnes en dictant la façon dont elle peuvent interagir les unes avec les autres, ainsi qu'en filtrant du contenu. YunoHost est développé par une communauté qui croit en un internet ouvert et décentralisé. Nous espérons que vous aussi !
--->
 - **Crées en una internet libre, abierta y descentralizada.** En una internet centralizada, entidades privadas y gobiernos pueden espiar, analizar e influir en nosotras dictando como iteraccionamos entre nosotras o filtrando contenidos. A YunoHost lo desarrolla por una comunidad que cree en una internet abierta y descentralizada. ¡Esperamos que tú también!
 
-<!-- 
-- **Vous voulez avoir le contrôle de vos données et services.** Vos images, vos messages de chat, votre historique de navigation, et votre dissertation pour l'école n'ont rien à faire sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud). Ces données font partie de votre vie privée, mais également de celle de votre famille, de vos amis, etc. Ces données devraient être gérées par *vous*, et non par une quelconque entreprise américaine qui cherche à analyser vos données pour revendre les résultats.
--->
 - **Quieres tener control de tus datos y servicios.** Tus fotos, mensajes de chat, el historial de navegación y ese trabajo del colegio no tienen nada que hacer en el ordenador de otra persona (alias La Nube). Esos datos forman parte de tu vida privada, pero también de la de tu familia, de tus amistades, etc. Estos datos deberían ser gestionados por *ti*, y no por una empresa americana cualquiera que busca analizar tus datos para vender los resultados.
 
-<!--
-- **Vous souhaitez apprendre comment fonctionnent les ordinateurs et Internet.** Opérer son propre serveur est un bon contexte pour apprendre les mécanismes de base au cœur des systèmes d'exploitation (OS) et d'Internet. Il vous faudra possiblement toucher à la ligne de commande et à des morceaux de configuration réseau et DNS.
- -->
 - **Quieres aprender cómo funcionan los ordenadores e internet.** Operar tu propio servidor es un ejercicio muy enriquecedor para entender los mecanismos básicos en el corazón de los sistemas operativos y de internet. Es posible que tengas que escribir en la línea de comandos o a segmentos de configuración de la red y de DNS.
 
-<!--
-- **Vous voulez explorer de nouvelles possibilités et personnaliser votre espace.** Avez-vous déjà rêvé d'avoir votre propre serveur Minecraft pour vos ami·e·s, ou un client IRC ou XMPP persistant ? Avec votre propre serveur, vous pouvez manuellement installer et faire tourner n'importe quel programme et personnaliser chaque morceau.
--->
-
 - **Quieres explorar las nuevas posibilidades y personalizar tu espacio.** ¿Alguna vez has soñado con tener tu propio servidor de Minecraft para jugar con tus amistades, o un cliente sw IRC o XMPP persistente? Con tu propio servidor, puedes instalar manualmente y ejecutar prácticamente cualquier programa que quieras y personalizar cada parte.
 
 ## ¿Qué implica el auto-alojamiento?
 
-<!--
-- **L'auto-hébergement requiert du travail et de la patience.** S'auto-héberger est un peu comme avoir son propre jardin ou potager : cela demande du travail et de la patience. Bien que YunoHost cherche à faire tout le travail compliqué pour vous, il vous faudra tout de même prendre le temps d'apprendre et configurer quelques détails pour que votre installation marche correctement. Il vous faudra aussi gérer quelques tâches de maintenance (telles que les mises à jour) de temps en temps, et demander de l'aide si des choses ne fonctionnent pas comme prévu.
--->
 - **Auto-alojarse requiere del trabajo y de la paciencia.** Auto-alojarte es algo parecido a cultivar tu propio jardín o huerto: requiere del trabajo y de la paciencia. Mientras que YunoHost pretende hacer todo el trabajo duro por ti, necesitarás tomarte el tiempo para aprender y configurar pequeños detalles para que tu instalación funcione correctamente. También necesitarás realizar algunas tareas de mantenimiento (como actualizaciones) de vez en cuando, o pedir soporte si las cosas no funcionan.
 
-<!--
-- **Avec de grands serveurs viennent les grandes responsabilités.** Opérer un serveur implique d'être responsable des données que vous hébergez : personne ne pourra récupérer des données à votre place si vous les perdez. YunoHost fournit des fonctionnalités de sauvegarde qu'il est recommandé d'utiliser pour sauvegarder les configurations et données importantes. Il vous faut aussi garder un œil sur les recommandations et les nouvelles à propos de la sécurité pour que votre serveur ou vos données ne soient pas compromises.
--->
 - **Un gran servidor conlleva una gran responsabilidad.** Operar un servidor significa que eres responsable de los datos que alojas. Nadie podrá recuperarlos por ti si se pierden. YunoHost proporciona funciones de copia de seguridad, que es recomendable utilizar regularmente para hacer copias de seguridad de las configuraciones y de los datos importantes. También deberías echar un ojo a las noticias y recomendaciones de seguridad, para que tu servidor o tus datos no se vean comprometidos.
 
-<!--
-- **La qualité et les performances ne seront probablement pas aussi bonnes que des services premium.** YunoHost (et la plupart des applications qui sont packagées) sont des logiciels libres et open-source, développés par des communautés bénévoles. Il n'y a pas de garantie absolue que ces logiciels fonctionneront dans toutes les circonstances possibles. Les performances de votre serveur auto-hébergé sont aussi liées au processeur, à la mémoire vive et à la connectivité internet.
--->
 - **La calidad y el rendimiento probablemente no serán tan buenos como los de los servicios "premium".** YunoHost (y la mayoría de las aplicaciones empaquetadas) son programas libres basados de código abierto, desarrollados por comunidades de personas de manera voluntaria. No hay garantía absoluta de que el software funcione en todas las circunstancias posibles. El rendimiento de su servidor autohospedado también está relacionado con su procesador, a la memoria RAM y la conectividad a internet.

pages/01.overview/05.self_hosting/self_hosting.it.md

@@ -30,5 +30,3 @@ Praticare il self-hosting non rende il "tuo internet" più sicuro e non fornisce
 - **Con grandi server derivano grandi responsabilità.** Gestire un server implica l'essere responsabile dei dati che ospiti: nessuno potrà recuperare i dati al tuo posto se li perderai. YunoHost offre funzionalità di salvataggio che è raccomandato utilizzare per memorizzare le configurazioni e i dati importanti. Devi tenere controllate le raccomandazioni e le novità riguardo la sicurezza perché il tuo server o i tuoi dati non vengano compromessi.
 
 - **La qualità e le performances probabilmente non saranno le stesse dei servizi premium.** YunoHost (e la maggior parte delle applicazioni che sono predisposte) sono programmi liberi e open-source, sviluppati da comunità di volontari. Non c'è la garanzia assoluta che i programmi funzionino in tutte le possibili situazioni. Le performance del tuo server self-hosting sono legate anche al processore, alla memoria RAM e alla connessione internet.
-
-

pages/01.overview/05.self_hosting/self_hosting.ru.md

@@ -17,13 +17,13 @@ routes:
 
 - **Вы верите в свободный, открытый и децентрализованный Интернет.** В централизованном Интернете частные компании и правительство могут шпионить, анализировать людей и влиять на них, диктуя, как они взаимодействуют друг с другом, и фильтруя контент. YunoHost разработан сообществом, которое верит в открытый и децентрализованный Интернет, и мы надеемся, что вы тоже верите!
 
-- **Вы хотите иметь контроль над своими данными и сервисами.** Вашим фотографиям, сообщениям в чате, истории посещенных страниц и тексту, который вы пишете для школы, нечего делать на чужом сервере (он же Облако). Они являются частью вашей личной жизни, но также и частью жизни вашей семьи, жизни вашего друга и так далее. Этими данными должны управлять * вы*, а не случайная компания в США, которая хочет, чтобы ваши данные анализировались и продавались результаты.
+- **Вы хотите иметь контроль над своими данными и сервисами.** Вашим фотографиям, сообщениям в чате, истории посещенных страниц и тексту, который вы пишете для школы, нечего делать на чужом сервере (он же Облако). Они являются частью вашей личной жизни, но также и частью жизни вашей семьи, жизни вашего друга и так далее. Этими данными должны управлять *вы*, а не случайная компания в США, которая хочет, чтобы ваши данные анализировались и продавались результаты.
 
 - **Вы хотите узнать о том, как работают компьютеры и Интернет.** Управление собственным сервером - довольно хороший контекст для понимания основных механизмов, лежащих в основе операционных систем и Интернета. Возможно, вам придется иметь дело с интерфейсом командной строки, сетевой архитектурой, конфигурацией DNS, SSH и так далее.
 
 - **Вы хотите исследовать новые возможности и настраивать вещи.** Вы когда-нибудь мечтали запустить сервер Minecraft для своих друзей или постоянный IRC или XMPP-клиент? Имея свой собственный сервер, вы можете вручную установить и запустить практически любую программу, которую пожелаете, и настроить все до мелочей.
 
-## Почему вы * не должны* принимать гостей сами?
+## Почему вы *не должны* принимать гостей сами?
 
 - **Самостоятельный хостинг требует некоторой работы и терпения.** Самостоятельный хостинг немного похож на выращивание собственного сада или овощей: это требует работы и терпения. В то время как YunoHost стремится выполнить всю тяжелую работу за вас, самостоятельный хостинг по-прежнему требует, чтобы вы потратили время на изучение и настройку нескольких вещей для правильной настройки вашего сервера. Вам также нужно будет время от времени выполнять задачи технического обслуживания (например, обновления) или обращаться за поддержкой, если что-то выйдет из строя.
 

pages/01.overview/10.what_is_yunohost/what_is_yunohost.ar.md

@@ -29,11 +29,10 @@ routes:
 
 ### أصل فكرة المشروع
 
-
 تعود نشأة فكرة مشروع واي يونوهوست YunoHost إلى شهر فيفري مِن عام 2012 بعد محادثة بدأت على هذا الشكل تقريبًا :
 
- <blockquote>« تبًا، لقد سئِمتُ مِن إعادة إعداد خادم البريد الإلكتروني ... Beudbeud، كيف قُمتَ بإعداد خادومك الجميل حول LDAP ؟ »
+> « تبًا، لقد سئِمتُ مِن إعادة إعداد خادم البريد الإلكتروني ... Beudbeud، كيف قُمتَ بإعداد خادومك الجميل حول LDAP ؟ »
-<small>Kload، فيفري 2012</small></blockquote>
+> <small>Kload، فيفري 2012</small>
 
 Il ne manquait en fait qu’une interface d’administration au serveur de Beudbeud pour en faire quelque chose d’exploitable, alors Kload a décidé de la développer. Finalement, après l’automatisation de quelques configurations et le packaging de quelques applications web, la première version de YunoHost était sortie.
 
@@ -79,4 +78,3 @@ Même si YunoHost est multi-domaine et multi-utilisateur, il reste **inappropri
 Premièrement parce que le logiciel est trop jeune, donc non-testé et non-optimisé pour être mis en production pour des centaines d’utilisateurs en même temps. Et quand bien même, ce n’est pas le chemin que l’on souhaite faire suivre à YunoHost. La virtualisation se démocratise, et c’est une façon bien plus étanche et sécurisée de faire de la mutualisation.
 
 Vous pouvez héberger vos amis, votre famille ou votre entreprise sans problème, mais vous devez **avoir confiance** en vos utilisateurs, et ils doivent de la même façon avoir confiance en vous. Si vous souhaitez tout de même fournir des services YunoHost à des inconnus, **un VPS entier par utilisateur** sera la meilleure solution.
-

pages/01.overview/10.what_is_yunohost/what_is_yunohost.de.md

@@ -23,13 +23,14 @@ YunoHost ist ein **Betriebssystem**, das auf die einfachste Verwaltung eines **S
 - ![](image://icon-mail.png?resize=32&classes=inline) Enthält einen **vollständigen E-Mail-Stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
 - ![](image://icon-messaging.png?resize=32&classes=inline) … sowie **einen Instant Messaging Server** <small>(XMPP)</small> ;
 - ![](image://icon-lock.png?resize=32&classes=inline) Verwaltet **SSL-Zertifikate** <small>(basierend auf Let's Encrypt)</small> ;
-- ![](image://icon-shield.png?resize=32&classes=inline) … und **Sicherheitssysteme** <small>(fail2ban, yunohost-firewall)</small> ;
+- ![](image://icon-shield.png?resize=32&classes=inline) … und **Sicherheitssysteme** <small>(`fail2ban`, `yunohost-firewall`)</small> ;
 
 ## Ursprung
 
 YunoHost wurde im Februar 2012 aus folgender Situation heraus erstellt:
 
- <blockquote><p>"Scheiße, ich bin zu faul, um meinen Mailserver neu zu konfigurieren ... Beudbeud, wie hast Du deinen kleinen Server mit LDAP zum Laufen gebracht?"</p><small> Kload, Februar 2012</small></blockquote>
+> "Scheiße, ich bin zu faul, um meinen Mailserver neu zu konfigurieren ... Beudbeud, wie hast Du deinen kleinen Server mit LDAP zum Laufen gebracht?"
+> <small> Kload, Februar 2012</small>
 
 Alles, was benötigt wurde, war eine Administrationsoberfläche für Beudbeud's Server, um etwas nutzbar zu machen, also entschied sich Kload, eine zu entwickeln. Schließlich wurde YunoHost v1, nach der Automatisierung mehrerer Konfigurationen und der Paketierung in einigen Webanwendungen, fertiggestellt.
 

pages/01.overview/10.what_is_yunohost/what_is_yunohost.es.md

@@ -23,20 +23,20 @@ YunoHost es un **sistema operativo** que persigue simplificar la administración
 - ![](image://icon-mail.png?resize=32&classes=inline) Incluye un **servidor de correo electrónico completo** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
 - ![](image://icon-messaging.png?resize=32&classes=inline) … así como un **servidor de mensajería instanea** <small>(XMPP)</small> ;
 - ![](image://icon-lock.png?resize=32&classes=inline) Administra **certificados SSL** <small>(generados por Let's Encrypt)</small> ;
-- ![](image://icon-shield.png?resize=32&classes=inline) … y los **sistemas de seguridad** <small>(fail2ban, yunohost-firewall)</small> ;
+- ![](image://icon-shield.png?resize=32&classes=inline) … y los **sistemas de seguridad** <small>(`fail2ban`, `yunohost-firewall`)</small> ;
 
 ## Origen
 
 YunoHost se creó en Febrero de 2012 tras algo así:
 
- <blockquote><p>"¡Mierda, soy muy vago para reconfigurar mi servidor de correo!… Beudbeud, ¿Cómo  hiciste para conectar tu pequeño servidor a LDAP?"</p>
+> "¡Mierda, soy muy vago para reconfigurar mi servidor de correo!… Beudbeud, ¿Cómo  hiciste para conectar tu pequeño servidor a LDAP?"
-<small>Kload, Febrero de 2012</small></blockquote>
+> <small>Kload, Febrero de 2012</small>
 
 Lo único que necesitaba era un interfaz de administración para el servidor de Beudbeud para tener algo usable, así que Kload decidió desarrollar uno. Finalmente, tras automatizar varias configuraciones y empaquetar algunas aplicaciones web, YunoHost v1 quedó terminado.
 
 Notando un entusiasmo creciente alrededor de YunoHost y del autoalojamiento en general, los desarrolladores originales junto con nuevas personas contribuyentes decidieron comenzar a trabajar en la versión 2, una versión más extensible, más potente, más fácil de usar, y ya de paso, una que prepare ricas tazas de café de comercio justo para los elfos de Laponia.
 
-El nombre **YunoHost** viene de la jerga "Y U NO Host". El [meme de Internet ](https://en.wikipedia.org/wiki/Internet_meme) debería ilustrarlo:
+El nombre **YunoHost** viene de la jerga "Y U NO Host". El [meme de Internet](https://en.wikipedia.org/wiki/Internet_meme) debería ilustrarlo:
 ![](image://dude_yunohost.jpg)
 
 ## ¿Qué no es YunoHost?

pages/01.overview/10.what_is_yunohost/what_is_yunohost.fr.md

@@ -23,14 +23,14 @@ YunoHost est un **système d’exploitation** qui vise à simplifier autant que
 - ![](image://icon-mail.png?resize=32&classes=inline) fourni avec un **serveur mail complet** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
 - ![](image://icon-messaging.png?resize=32&classes=inline) ... ainsi qu'un **serveur de messagerie instantanée** <small>(XMPP)</small> ;
 - ![](image://icon-lock.png?resize=32&classes=inline) gère les **certificats SSL** <small>(basé sur Let's Encrypt)</small> ;
-- ![](image://icon-shield.png?resize=32&classes=inline) ... et des **systèmes de sécurité** <small>(Fail2Ban, yunohost-firewall)</small>.
+- ![](image://icon-shield.png?resize=32&classes=inline) ... et des **systèmes de sécurité** <small>(`fail2ban`, `yunohost-firewall`)</small>.
 
 ## Origine
 
 YunoHost est un projet né en février 2012 à la suite d’à peu près ça :
 
- <blockquote><p>« Merde, j’ai la flemme de me reconfigurer un serveur mail... Beudbeud, comment t’as fait pour configurer ton joli serveur sous LDAP ? »</p>
+> « Merde, j’ai la flemme de me reconfigurer un serveur mail... Beudbeud, comment t’as fait pour configurer ton joli serveur sous LDAP ? »
-<small>Kload, février 2012</small></blockquote>
+> <small>Kload, février 2012</small>
 
 Il ne manquait en fait qu’une interface d’administration au serveur de Beudbeud pour en faire quelque chose d’exploitable, alors Kload a décidé de la développer. Finalement, après l’automatisation de quelques configurations et le packaging de quelques applications web, la première version de YunoHost était sortie.
 

pages/01.overview/10.what_is_yunohost/what_is_yunohost.it.md

@@ -16,20 +16,21 @@ YunoHost è un **sistema operativo** che mira a rendere il più semplice possibi
 - ![](image://icon-debian.png?resize=32&classes=inline) Basato su Debian;
 - ![](image://icon-tools.png?resize=32&classes=inline) Amministra il tuo server attraverso **un'interfaccia web amichevole** ;
 - ![](image://icon-package.png?resize=32&classes=inline) Installa le **applicazioni in pochi clic**;
-- ![](image://icon-users.png?resize=32&classes=inline) Gestisci **gli utenti ** <small>(basato su LDAP)</small>;
+- ![](image://icon-users.png?resize=32&classes=inline) Gestisci **gli utenti** <small>(basato su LDAP)</small>;
 - ![](image://icon-globe.png?resize=32&classes=inline) Gestisci **i nomi di dominio**;
 - ![](image://icon-medic.png?resize=32&classes=inline) Crea e ripristina  **i backup**;
 - ![](image://icon-door.png?resize=32&classes=inline) Connettiti contemporaneamente a tutte le applicazioni  attraverso **il portale utente** <small>(NGINX, SSOwat)</small>;
 - ![](image://icon-mail.png?resize=32&classes=inline) Include uno **stack di posta elettronica completo** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
 - ![](image://icon-messaging.png?resize=32&classes=inline)... e anche un **server di messaggistica istantanea** <small>(XMPP)</small>;
 - ![](image://icon-lock.png?resize=32&classes=inline) Gestisce i **certificati SSL** <small>(basati su Let's Encrypt)</small> ;
-- ![](image://icon-shield.png?resize=32&classes=inline)... e i **sistemi di sicurezza** <small>(Fail2ban, yunohost-firewall)</small>;
+- ![](image://icon-shield.png?resize=32&classes=inline)... e i **sistemi di sicurezza** <small>(`fail2ban`, `yunohost-firewall`)</small>;
 
 ## Origine
+
 YunoHost è stata creata nel febbraio 2012 dopo qualcosa del genere:
 
-<blockquote><p>"Merda, sono troppo pigro per riconfigurare il mio server di posta... Beudbeud, come sei riuscito a far funzionare il tuo piccolo server con LDAP?"</p>
+> "Merda, sono troppo pigro per riconfigurare il mio server di posta... Beudbeud, come sei riuscito a far funzionare il tuo piccolo server con LDAP?"
-<small>Kload, Febbraio 2012</small></blockquote>
+> <small>Kload, Febbraio 2012</small>
 
 Tutto ciò che serviva era un'interfaccia di amministrazione per il server di Beudbeud per creare qualcosa di utilizzabile, così Kload ha deciso di svilupparne una. Alla fine, dopo aver automatizzato diverse configurazioni e aver inserito alcune applicazioni web, YunoHost versione 1 è stato completato.
 

pages/01.overview/10.what_is_yunohost/what_is_yunohost.md

@@ -23,14 +23,14 @@ YunoHost is an **operating system** aiming to simplify **server administration**
 - ![](image://icon-mail.png?resize=32&classes=inline) Includes a **full e-mail stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
 - ![](image://icon-messaging.png?resize=32&classes=inline)... as well as **an instant messaging server** <small>(XMPP)</small>;
 - ![](image://icon-lock.png?resize=32&classes=inline) Manages **SSL certificates** <small>(based on Let's Encrypt)</small>;
-- ![](image://icon-shield.png?resize=32&classes=inline)... and **security systems** <small>(Fail2ban, yunohost-firewall)</small>.
+- ![](image://icon-shield.png?resize=32&classes=inline)... and **security systems** <small>(`fail2ban`, `yunohost-firewall`)</small>.
 
 ## Origin
 
 YunoHost was created in February 2012 after something like this:
 
-<blockquote><p>"Shit, I'm too lazy to reconfigure my mail server... Beudbeud, how were you able to get your little server running with LDAP?"</p>
+> "Shit, I'm too lazy to reconfigure my mail server... Beudbeud, how were you able to get your little server running with LDAP?"
-<small>Kload, February 2012</small></blockquote>
+> <small>Kload, February 2012</small>
 
 All that was needed was an admin interface for Beudbeud's server to make something usable, so Kload decided to develop one. Finally, after automating several configs and packaging in some web apps, YunoHost v1 was finished.
 

pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md

@@ -23,14 +23,14 @@ YunoHost это **операционная система** позволяюща
 - ![](image://icon-mail.png?resize=32&classes=inline) Включает **полный набор для работы электронной почты** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
 - ![](image://icon-messaging.png?resize=32&classes=inline)... более известный как **встроенный сервер сообщений** <small>(XMPP)</small>;
 - ![](image://icon-lock.png?resize=32&classes=inline) Управляй **SSL сертификатами** <small>(Основано на Let's Encrypt)</small> ;
-- ![](image://icon-shield.png?resize=32&classes=inline)... и **системами безопасности** <small>(Fail2ban, yunohost-firewall)</small>;
+- ![](image://icon-shield.png?resize=32&classes=inline)... и **системами безопасности** <small>(`fail2ban`, `yunohost-firewall`)</small>;
 
 ## История
 
 YunoHost был создан в Феврале 2012 после чего-то вроде:
 
-<blockquote><p>"Блин, Я слишком ленив чтобы перенастроить мой почтовый сервер... Beudbeud, как вам удалось запустить свой малеький сервер LDAP?"</p>
+> "Блин, Я слишком ленив чтобы перенастроить мой почтовый сервер... Beudbeud, как вам удалось запустить свой малеький сервер LDAP?"
-<small>Kload, Февраль 2012</small></blockquote>
+> <small>Kload, Февраль 2012</small>
 
 Всё что было нужно - админ панель для сервера Beudbeud-а чтобы сделать что-то юзабельное, поэтому Kload решил её разработать. В итоге, после автоматизации нескольких конфигураций и упаковки некоторых Веб-приложений, YunoHost v1 был завершён.
 

pages/02.administer/05.how_to_host_yourself/how_to_host_yourself.ru.md

@@ -12,6 +12,7 @@ routes:
 ### Дома, например, на плате ARM или старом компьютере
 
 Вы можете запустить YunoHost у себя дома с помощью платы ARM или переоборудованного обычного компьютера, подключенного к вашему домашнему роутеру.
+
 - **Плюсы** : у вас будет физический контроль над машиной, и вам нужно будет только купить оборудование;
 - **Минусы** : вам придется [вручную настроить свой роутер](/isp_box_config) и [возможные ограничения вашим провайдером](/isp).
 
@@ -21,7 +22,7 @@ VPN - это зашифрованный туннель между двумя к
 
 - **Плюсы** : у вас будет физический контроль над машиной, а VPN скрывает ваш трафик от вашего интернет-провайдера и позволяет вам обойти его ограничения;
 - **Минусы** : вам придется оплатить ежемесячную подписку на VPN.
-- 
+
 ### На удалённом сервере (VPS или выделенный)
 
 Вы можете арендовать виртуальный частный сервер (VPS) или выделенную машину у [ассоциации](https://db.ffdn.org/) или [коммерческие](/providers/server) облачные провайдеры.

pages/02.administer/10.install/05.images/docs.fr.md

@@ -45,7 +45,6 @@ Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
     </div>
 </template>
 
-
 <script>
 /*
 ###############################################################################
@@ -81,4 +80,3 @@ $(document).ready(function () {
     });
 });
 </script>
-

pages/02.administer/10.install/05.images/images.de.md

@@ -39,7 +39,6 @@ N B : Auch wenn das Image nicht der neuesten Version von YunoHost entspricht, k
     </div>
 </template>
 
-
 <script>
 /*
 ###############################################################################
@@ -75,4 +74,3 @@ $(document).ready(function () {
     });
 });
 </script>
-

pages/02.administer/10.install/05.images/images.es.md

@@ -38,7 +38,6 @@ N.B. : Incluso si la imagen no corresponde con la última versión de YunoHost,
     </div>
 </template>
 
-
 <script>
 /*
 ###############################################################################
@@ -74,5 +73,3 @@ $(document).ready(function () {
     });
 });
 </script>
-
-

pages/02.administer/10.install/05.images/images.fr.md

@@ -40,7 +40,6 @@ Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
     </div>
 </template>
 
-
 <script>
 /*
 ###############################################################################
@@ -76,4 +75,3 @@ $(document).ready(function () {
     });
 });
 </script>
-

pages/02.administer/10.install/05.images/images.md

@@ -40,7 +40,6 @@ This page requires Javascript enabled to display properly :s.
     </div>
 </template>
 
-
 <script>
 /*
 ###############################################################################
@@ -76,4 +75,3 @@ $(document).ready(function () {
     });
 });
 </script>
-

pages/02.administer/10.install/05.images/images.ru.md

@@ -40,7 +40,6 @@ routes:
     </div>
 </template>
 
-
 <script>
 /*
 ###############################################################################
@@ -76,4 +75,3 @@ $(document).ready(function () {
     });
 });
 </script>
-

pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.de.md

@@ -10,14 +10,17 @@ routes:
 Bei einer Installation zu Hause sollte Ihr Server normalerweise über die Domäne`yunohost.local` erreichbar sein. Wenn dies aus irgendeinem Grund nicht funktioniert, müssen Sie möglicherweise die *lokale* IP-Adresse Ihres Servers ermitteln.
 
 ## Was ist ein locales IP ?
+
 Die lokale IP-Adresse ist die, die verwendet wird, um auf Ihren Server innerhalb des lokalen Netzwerks (typischerweise Ihr Zuhause) zu verweisen, wo mehrere Geräte an einen Router (Ihre Internetbox) angeschlossen sind. Die lokale IP-Adresse sieht typischerweise so aus `192.168.x.y` (oder manchmal `10.0.x.y` oder `172.16.x.y`)
 
 ## Wie findet man es?
+
 Jeder dieser Tricks sollte es Ihnen ermöglichen, die lokale IP-Adresse Ihres Servers zu finden:
 [ui-tabs position="top-left" active="0" theme="lite"]
 [ui-tab title="(Empfohlen) Mit Angry IP Scanner"]
 
 Verwenden Sie dazu die [AngryIP](https://angryip.org/download/) Software. Sie Brauchen nur diese lokalen IP-Bereiche in dieser Reihenfolge durchsuchen, bis Sie die aktive IP-Adresse finden, die Ihrem Server entspricht:
+
 - `192.168.0.0` -> `192.168.0.255`
 - `192.168.1.0` -> `192.168.1.255`
 - `192.168.2.0` -> `192.168.255.255`
@@ -44,8 +47,9 @@ Wenn der Befehl `arp-scan` viele Geräte anzeigt, können Sie dann mit dem Befeh
 Bildschirm auf den Server anschliessen, sich einloggen und diesen Befehl eingeben`hostname --all-ip-address`.
 
 Die Standard-Anmeldedaten (vor der Nachinstallation!) zum Einloggen sind:
-- login: root
+
-- password: yunohost
+- login: `root`
+- password: `yunohost`
 
 (Wenn Sie ein rohes Armbian-Image anstelle des vorinstallierten YunoHost-Images verwenden, lauten die Anmeldedatenen root / 1234)
 

pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.fr.md

@@ -10,14 +10,17 @@ routes:
 Dans le cas d'une installation à la maison, votre serveur devrait typiquement être accessible (depuis son réseau local) avec le domaine `yunohost.local`. Si pour une raison quelconque cela ne fonctionne pas, il vous faut peut-être trouver l'IP locale de votre serveur.
 
 ## Qu'est ce qu'une IP locale ?
+
 L'IP locale d'une machine est utilisée pour y faire référence à l'intérieur d'un réseau local (typiquement le réseau dans une maison) où plusieurs appareils se connectent à un même routeur (votre box internet). Une adresse IP locale ressemble généralement à `192.168.x.y` (ou parfois `10.0.x.y` ou `172.16.x.y`)
 
 ## Comment la trouver ?
+
 L'une de ces astuces devrait permettre de trouver l'IP locale de votre serveur :
 [ui-tabs position="top-left" active="0" theme="lite"]
 [ui-tab title="(Recommandé) Avec AngryIP"]
 
 Vous pouvez utiliser le logiciel [AngryIP](https://angryip.org/download/) pour y parvenir. Vous devez juste scanner ces plages d'IP dans cet ordre jusqu'à trouver l'IP correspondante à votre serveur :
+
 - `192.168.0.0` -> `192.168.0.255`
 - `192.168.1.0` -> `192.168.1.255`
 - `192.168.2.0` -> `192.168.255.255`
@@ -44,8 +47,9 @@ Si la commande `arp-scan` vous affiche beaucoup de machines, vous pouvez vérifi
 Branchez un écran sur votre serveur, loggez-vous et tapez `hostname --all-ip-address`.
 
 Les identifiants par défaut (avant la post-installation!) sont :
-- login : root
+
-- mot de passe : yunohost
+- login : `root`
+- mot de passe : `yunohost`
 
 (Si vous utilisez une image Armbian brute plutôt que les images YunoHost pré-installées, les identifiants sont root / 1234)
 
@@ -53,6 +57,7 @@ Les identifiants par défaut (avant la post-installation!) sont :
 [/ui-tabs]
 
 ## Je ne trouve toujours pas mon IP locale
+
 Si vous n'êtes pas capable de trouver votre serveur avec les méthodes précédentes, alors peut-être que votre serveur n'a pas démarré correctement.
 
 - Assurez-vous que le serveur est correctement branché ;

pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.md

@@ -10,14 +10,17 @@ routes:
 On an installation at home, your server should typically be accessible using the `yunohost.local` domain. If for any reason this does not work, you may need to find the *local* IP of your server.
 
 ## What is a local IP ?
+
 The local IP is the address used to refer to your server inside the local network (typically your home) where multiple devices are connected to a router (your internet box). The local IP typically looks like `192.168.x.y` (or sometimes `10.0.x.y` or `172.16.x.y`)
 
 ## How to find it ?
+
 Any of these tricks should allow you to find the local IP of your server:
 [ui-tabs position="top-left" active="0" theme="lite"]
 [ui-tab title="(Recommended) With AngryIP"]
 
 You can use the [AngryIP](https://angryip.org/download/) software to achieve that. You just need to scan these local ip ranges in this order until you find the active IP corresponding to your server:
+
 - `192.168.0.0` -> `192.168.0.255`
 - `192.168.1.0` -> `192.168.1.255`
 - `192.168.2.0` -> `192.168.255.255`
@@ -44,8 +47,9 @@ If the `arp-scan` command displays a confusing number of devices, you can check
 Plug a screen on your server, log in and type `hostname --all-ip-address`.
 
 The default credentials (before post-installation!) to log in are:
-- login: root
+
-- password: yunohost
+- login: `root`
+- password: `yunohost`
 
 (If you are using a raw Armbian image instead of the pre-installed YunoHost image, the credentials are root / 1234)
 

pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md

@@ -10,14 +10,17 @@ routes:
 При установке дома ваш сервер, как правило, должен быть доступен с использованием домена `yunohost.local`. Если по какой-либо причине это не сработает, возможно, вам потребуется найти *локальный* IP-адрес вашего сервера.
 
 ## Что такое локальный IP-адрес ?
+
 Локальный IP-адрес - это адрес, используемый для обращения к вашему серверу внутри локальной сети (обычно вашего дома), где несколько устройств подключены к маршрутизатору. Локальный IP-адрес обычно выглядит как `192.168.x.y` (или иногда `10.0.x.y` или `172.16.x.y`).
 
 ## Как его найти ?
+
 Любой из этих приемов должен позволить вам найти локальный IP-адрес вашего сервера:
 [ui-tabs position="top-left" active="0" theme="lite"]
 [ui-tab title="(Рекомендуемый) используя AngryIP"]
 
 Вы можете использовать [AngryIP](https://angryip.org/download/) для достижения этой цели. Вам просто нужно сканировать эти локальные диапазоны ip-адресов в таком порядке, пока вы не найдете активный IP-адрес, соответствующий вашему серверу:
+
 - `192.168.0.0` -> `192.168.0.255`
 - `192.168.1.0` -> `192.168.1.255`
 - `192.168.2.0` -> `192.168.255.255`
@@ -27,7 +30,7 @@ routes:
 !!! **Советы**:
 !!! - вы можете сделать отсортировать по ping, как показано на этом скриншоте, чтобы легко увидеть используемый IP.
 !!! - обычно ваш сервер должен отображаться как прослушивающий на портах 80 и 443
-!!! - в случае сомнений просто введите `https://192.168.x.y " в вашем браузере, чтобы проверить, является ли это YunoHost или нет.
+!!! - в случае сомнений просто введите `https://192.168.x.y` в вашем браузере, чтобы проверить, является ли это YunoHost или нет.
 
 ![](image://angryip.png?class=inline)
 
@@ -44,8 +47,9 @@ routes:
 Подключите экран к своему серверу, войдите в систему и введите `hostname --all-ip-address`.
 
 Учетные данные по умолчанию (перед постустановкой!) для входа в систему:
-- логин: root
+
-- пароль: yunohost
+- логин: `root`
+- пароль: `yunohost`
 
 (Если вы используете необработанный образ Armbian вместо предустановленного образа YunoHost, учетные данные - root / 1234)
 

pages/02.administer/10.install/15.isp_box_config/isp_box_config.de.md

@@ -25,6 +25,7 @@ Ihre Box/Router-Administrationsoberfläche ist in der Regel erreichbar über [ht
 ### 2. Die lokale IP Ihres Servers finden
 
 Identifizieren Sie die lokale IP Ihres Servers, entweder :
+
 - von Ihrer Box/Router-Schnittstelle, die möglicherweise angeschlossene Geräte auflistet
 - über die YunoHost-Schnittstelle, Abschnitt "Internetkonnektivität", dann auf "Details" im IPv4-Bericht klicken.
 - von der Befehlszeile Ihres Servers aus, indem Sie `hostname -I` ausführen
@@ -39,12 +40,13 @@ Suchen Sie in der Verwaltungsoberfläche Ihres Routers nach etwas wie "Router-Ko
 
 Das Öffnen der unten aufgeführten Ports ist notwendig, damit die verschiedenen in YunoHost verfügbaren Dienste funktionieren. Für jeden von ihnen wird die 'TCP'-Weiterleitung benötigt. Einige Schnittstellen beziehen sich auf 'externe' und 'interne' Ports : diese sind in unserem Fall gleich.
 
-* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
+- Web: `80` <small>(HTTP)</small>, `443` <small>(HTTPS)</small>
-* [SSH](/ssh): 22
+- [SSH](/ssh): `22`
-* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
+- [XMPP](/XMPP): `5222` <small>(clients)</small>, `5269` <small>(servers)</small>
-* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
+- [Email](/email): `25`, `587` <small>(SMTP)</small>, `993` <small>(IMAP)</small>
 
 Wenn Sie sowohl ein Modem als auch einen Router verwenden, dann müssen Sie Folgendes tun:
+
 1. zuerst auf dem Modem (der Box, die dem Internet am nächsten ist) Regeln erstellen, um die oben genannten Ports an Ihren Router weiterzuleiten;
 2. dann auf dem Router (der Box zwischen dem Modem und Ihren Geräten) Regeln erstellen, um die oben genannten Ports an die statische IP-Adresse für Ihren Server weiterzuleiten.
 

pages/02.administer/10.install/15.isp_box_config/isp_box_config.es.md

@@ -25,12 +25,13 @@ Una vez que tienes la redirección configurada, deberías poder comprobar que lo
 
 ### 1. Acceder a la interfaz de administración de tu router/caja/box
 
-En general la interfaz de administración está accesible desde http://192.168.0.1 o http://192.168.1.1. 
+En general la interfaz de administración está accesible desde <http://192.168.0.1> o <http://192.168.1.1>.
 Luego, es posible que tengas que autenticarte con los ID provechos pour tu proveedor de acceso a Internet.
 
 ### 2. Descubrir la IP local del servidor
 
 Identifica cuál es la IP local de tu servidor, o sea :
+
 - desde la interfaz de tu router/caja/box, donde tal vez estén listados los dipositivos conectados a la red local
 - desde la webadmin de YunoHost, en 'Estado del servidor', 'Red'
 - desde la línea de comandos en tu servidor, por ejemplo con `ip a | grep "scope global" | awk '{print $2}'`
@@ -43,10 +44,10 @@ En la interfaz de administración de tu router/caja/box, tienes que encontrar un
 
 Luego tienes que redirigir cada uno de los puertos listados a continuación hacia la IP local de tu router para que los varios servicios de YunoHost funcionen. Para cada uno de ellos, una redirección 'TCP' es necesaria. En algunas interfaces, tal vez encontrarás referencias a un puerto 'externo' y un puerto 'interno' : en nuestro caso, se trata del mismo número de puerto, que sea interno o externo.
 
-* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
+- Web: `80` <small>(HTTP)</small>, `443` <small>(HTTPS)</small>
-* [SSH](/ssh): 22
+- [SSH](/ssh): `22`
-* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
+- [XMPP](/XMPP): `5222` <small>(clients)</small>, `5269` <small>(servers)</small>
-* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
+- [Email](/email): `25`, `587` <small>(SMTP)</small>, `993` <small>(IMAP)</small>
 
 ! [fa=exclamation-triangle /] Algunos proveedores de acceso a Internet bloquean el puerto 25 (mail SMTP) por defecto para luchar con el spam. Otros (más escasos) no permiten utilizar libremente los puertos 80/443. Dependiendo de tu proveedor, puede ser posible de abrir estos puertos en la interfaz... Ver [esta página](/isp) por más informaciones.
 
@@ -54,8 +55,6 @@ Luego tienes que redirigir cada uno de los puertos listados a continuación haci
 
 Una tecnología llamada UPnP está disponible en algunos routers/cajas/box y permite redirigir automáticamente puertos hacia una máquina que lo pide. Si UPnP está activado en tu casa, ejecutar este comando debería automáticamente redirigir los puertos correctos :
 
-
 ```bash
 sudo yunohost firewall reload
 ```
-

pages/02.administer/10.install/15.isp_box_config/isp_box_config.fr.md

@@ -22,13 +22,14 @@ YunoHost 3.8 vous permettra de vérifier si les ports sont correctement exposés
 
 ### 2. Accéder à l'interface d'administration de votre box/routeur
 
-L'interface d'administration est généralement accessible via http://192.168.0.1 ou http://192.168.1.1.
+L'interface d'administration est généralement accessible via <http://192.168.0.1> ou <http://192.168.1.1>.
 Ensuite, il vous faudra peut-être vous authentifier avec les identifiants
 fournis par votre fournisseur d'accès à Internet (FAI).
 
 ### 3. Trouver l'IP locale de votre serveur
 
 Identifiez quelle est l'IP locale de votre serveur, soit :
+
 - depuis l'interface de votre routeur/box, qui liste peut-être les dispositifs
   connectés;
 - depuis la webadmin de YunoHost, dans 'Diagnostic', section 'Connectivité Internet', cliquer sur 'Détails' à côté de la ligne sur IPv4.
@@ -44,10 +45,10 @@ nom diffère suivant le type / marque de la box...
 
 Il vous faut ensuite rediriger chacun des ports listés ci-dessous vers l'IP locale de votre serveur pour que les différents services de YunoHost fonctionnent. Pour chacun d'eux, une redirection 'TCP' est nécessaire. Certaines interfaces font référence à un port « externe » et un port « interne » : dans notre cas il s'agit du même.
 
-* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
+- Web : `80` <small>(HTTP)</small>, `443` <small>(HTTPS)</small>
-* [SSH](/ssh): 22
+- [SSH](/ssh) : `22`
-* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(serveurs)</small>
+- [XMPP](/XMPP) : `5222` <small>(clients)</small>, `5269` <small>(serveurs)</small>
-* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
+- [Email](/email) : `25`, `587` <small>(SMTP)</small>, `993` <small>(IMAP)</small>
 
 ! [fa=exclamation-triangle /] Certains fournisseurs d'accès à Internet bloquent le port 25 (mail SMTP) par défaut pour combattre le spam. D'autres (plus rares) ne permettent pas d'utiliser librement les ports 80/443. En fonction de votre FAI, il peut être possible d'ouvrir ces ports dans l'interface... Voir [cette page](/isp) pour plus d'informations.
 

pages/02.administer/10.install/15.isp_box_config/isp_box_config.md

@@ -39,12 +39,13 @@ In your router admin interface, look for something like 'router configuration' o
 
 Opening the ports listed below is necessary for the various services available in YunoHost to work. For each of them, the 'TCP' forwarding is needed. Some interfaces refer to 'external' and 'internal' ports : these are the same in our case.
 
-* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
+- Web: `80` <small>(HTTP)</small>, `443` <small>(HTTPS)</small>
-* [SSH](/ssh): 22
+- [SSH](/ssh): `22`
-* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
+- [XMPP](/XMPP): `5222` <small>(clients)</small>, `5269` <small>(servers)</small>
-* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
+- [Email](/email): `25`, `587` <small>(SMTP)</small>, `993` <small>(IMAP)</small>
 
 If you use both a modem and a router, then you need to do the following:
+
 1. first on the modem (the box closest to the internet) create rules to forward the above ports to your router;
 2. then on the router (the box between the modem and your devices) create rules to forward the above ports to the static IP address for your server.
 
@@ -57,4 +58,3 @@ A technology called UPnP is available on some internet boxes / routers and allow
 ```bash
 sudo yunohost firewall reload
 ```
-

pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md

@@ -24,6 +24,7 @@ routes:
 ### 2. Найдите локальный IP-адрес вашего сервера
 
 Определите, каков *локальный* IP вашего сервера, либо :
+
 - из вашего интерфейса box / router, в котором может быть список подключенных устройств
 - в веб-администраторе YunoHost, в разделе "Диагностика", "Подключение к Интернету", нажмите "Подробности" в отчете IPv4.
 - из командной строки на вашем сервере, запустив `hostname -I`
@@ -38,12 +39,13 @@ routes:
 
 Открытие перечисленных ниже портов необходимо для работы различных сервисов, доступных в YunoHost. Для каждого из них необходима переадресация "TCP". Некоторые интерфейсы относятся к "внешним" и "внутренним" портам: в нашем случае это одно и то же.
 
-* Веб: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
+- Веб: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
-* [SSH](/ssh): 22
+- [SSH](/ssh): 22
-* [XMPP](/XMPP): 5222 <small>(клиенты)</small>, 5269 <small>(серверы)</small>
+- [XMPP](/XMPP): 5222 <small>(клиенты)</small>, 5269 <small>(серверы)</small>
-* [Почтовые](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
+- [Почтовые](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
 
 Если вы используете и модем, и маршрутизатор, то вам необходимо выполнить следующее:
+
 1. сначала на модеме (поле, расположенном ближе всего к Интернету) создайте правила для перенаправления вышеуказанных портов на ваш маршрутизатор;
 2. затем на маршрутизаторе (поле между модемом и вашими устройствами) создайте правила для пересылки вышеуказанных портов на статический IP-адрес вашего сервера.
 
@@ -56,4 +58,3 @@ routes:
 ```bash
 sudo yunohost firewall reload
 ```
-

pages/02.administer/10.install/20.dns_config/dns_config.de.md

@@ -17,9 +17,11 @@ sollte die Konfiguration automatisch erfolgen. Wenn Sie Ihren eigenen Domainname
 Domain über die Schnittstelle Ihres Registrars konfigurieren.
 
 ## Empfohlene DNS-Konfiguration
-_N.B. : Die Beispiele hier verwenden den Text: `your.domain.tld`, der durch Ihre eigene Domain (z. B.`www.yunohost.org`) zu ersetzen ist._
+
+*N.B. : Die Beispiele hier verwenden den Text: `your.domain.tld`, der durch Ihre eigene Domain (z. B.`www.yunohost.org`) zu ersetzen ist.*
 
 YunoHost bietet eine empfohlene DNS-Konfiguration, die auf zwei Arten zugänglich ist :
+
 - mit dem Webadmin, unter Domänen > your.domain.tld > DNS-Konfiguration ;
 - oder auf der Kommandozeile  `yunohost domain dns-conf your.domain.tld`
 
@@ -79,7 +81,7 @@ dargestellt wird:
 |   TXT   |  mail._domainkey       |  `"v=DKIM1; k=rsa; p=irgendeingrooßerSchlüssel"`       |
 |   TXT   |  _dmarc                |  `"v=DMARC1; p=none"`                                  |
 
-#### Einige Hinweise zu dieser Tabelle
+### Einige Hinweise zu dieser Tabelle
 
 - Nicht alle dieser Aufzeichnungen sind notwendig. Für eine Minimalinstallation werden nur die fett gedruckten Datensätze benötigt;
 - Der Punkt am Ende `your.domain.tld.` ist wichtig ;) ;
@@ -87,7 +89,7 @@ dargestellt wird:
 - Die hier gezeigten Werte sind nur Beispiele! Beziehen Sie sich auf die generierte Konfiguration, um herauszufinden, welche Werte zu verwenden sind;
 - Wir empfehlen eine [TTL](https://de.wikipedia.org/wiki/Time_to_Live#Domain_Name_System) von 3600 (1 Stunde). Es ist aber auch möglich einen anderen Wert zu verwenden, wenn Sie wissen, was Sie tun ;
 - Legen Sie keinen IPv6-Eintrag an, wenn Sie nicht sicher sind, daß IPv6 auf Ihrem Server funktioniert! Sie werden Probleme mit Let's Encrypt haben, wenn dies nicht der Fall ist.
-- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**: _tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
+- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: `_xmpp-client` **Protocol**: `_tcp` **Priority**: `0` **Weight**: `5` **Port**: `5222` **Target**: `your.domain.tld`
 
 ### Reverse DNS
 
@@ -97,12 +99,12 @@ für Ihre öffentlichen IPv4- und/oder IPv6-Adressen. Dadurch wird verhindert, d
 
 **N.B. : Die Reverse-DNS-Konfiguration erfolgt bei Ihrem Internet Service Provider bzw. VPS-Host. Es betrifft *nicht* den Registrar Ihres Domainnamens.**
 
-Das heißt, wenn Ihre öffentliche IPv4-Adresse `111.222.333.444`ist  und Ihr
+Das heißt, wenn Ihre öffentliche IPv4-Adresse `111.222.333.444` ist und Ihr
-Domänename `domain.tld`ist, sollten Sie mit dem Befehl 
+Domänename `domain.tld` ist, sollten Sie mit dem Befehl
 `nslookup` das folgende Ergebnis erhalten :
 
-```shell
+```bash
-$ nslookup 111.222.333.444
+nslookup 111.222.333.444
 444.333.222.111.in-addr.arpa    name = domain.tld.
 ```
 

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

@@ -13,11 +13,12 @@ DNS (sistema de nombre de dominios) es un elemento esencial de Internet que perm
 
 Si utilizas un [dominio automático](/dns_nohost_me) provecho por el Proyecto YunoHost, la configuración debería ser automática. Si quieres utilizar tu propio nombre de dominio (comprado a un registrar), hay que configurar manualmente tu proprio nombre de dominio vía la interfaz de tu registrar.
 
-
 ## Configuración DNS recomendada
-_Nota: los ejemplos utilizan el marcador `tu.dominio.tld`, debe ser reemplazado por su propio dominio, como `www.yunohost.org`._
+
+*Nota: los ejemplos utilizan el marcador `tu.dominio.tld`, debe ser reemplazado por su propio dominio, como `www.yunohost.org`.*
 
 YunoHost provee una configuración DNS recomendada, accesible vía :
+
 - la webadmin, en Dominios > tu.dominio.tld > Configuración DNS ;
 - o la linea de comando, `yunohost domain dns-conf tu.dominio.tld`
 
@@ -57,7 +58,6 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
 
 Pero puede ser un poco más fácil entenderla viéndola de esta manera :
 
-
 | Tipo    | Nombre                 | Valor                                                  |
 | :-----: | :--------------------: | :----------------------------------------------------: |
 |  **A**  |   **@**                |  `111.222.333.444` (tu IPv4)                           |
@@ -65,7 +65,7 @@ Pero puede ser un poco más fácil entenderla viéndola de esta manera :
 |  AAAA   |   @                    |  `2222:444:8888:3333:bbbb:5555:3333:1111` (tu IPv6)    |
 |  AAAA   |   *                    |  `2222:444:8888:3333:bbbb:5555:3333:1111` (tu IPv6)    |
 | **SRV** | **_xmpp-client._tcp**  |  `0 5 5222 tu.dominio.tld.`                            |
-| **SRV** | **_xmpp-server._tcp**  |  `0 5 5269 tu.dominio.tld.`			    |
+| **SRV** | **_xmpp-server._tcp**  |  `0 5 5269 tu.dominio.tld.`                            |
 |  CNAME  |   muc                  |  `@`                                                   |
 |  CNAME  |   pubsub               |  `@`                                                   |
 |  CNAME  |   vjud                 |  `@`                                                   |
@@ -75,7 +75,7 @@ Pero puede ser un poco más fácil entenderla viéndola de esta manera :
 |   TXT   |  mail._domainkey       |  `"v=DKIM1; k=rsa; p=uneGrannnndeClef"`                |
 |   TXT   |  _dmarc                |  `"v=DMARC1; p=none"`                                  |
 
-#### Algunas notas a propósito de esta tabla :
+### Algunas notas a propósito de esta tabla
 
 - Todos los registros no son necesarios. Para una instalación mínima, solos los registros en negrita son necesarios.
 - El punto al final de `tu.dominio.tld.` es importante ;) ;
@@ -83,7 +83,7 @@ Pero puede ser un poco más fácil entenderla viéndola de esta manera :
 - ¡ Los valores mostrados son ejemplos ! Refiérete a la configuración generada por tu servidor qué valores utilizar.
 - Recomendamos un [TTL](https://en.wikipedia.org/wiki/Time_to_live) de 3600 (1 hora). Pero puedes utilizar otro valor si sabes lo que estás haciendo ;
 - ¡ No pongas registros IPv6 si no estás seguro que el IPv6 funcione en tu servidor ! Tendrás problemas con Let's Encrypt si no es el caso :-)
-- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**: _tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
+- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: `_xmpp-client` **Protocol**: `_tcp` **Priority**: `0` **Weight**: `5` **Port**: `5222` **Target**: `your.domain.tld`
 
 ### IP Dinámica
 

pages/02.administer/10.install/20.dns_config/dns_config.fr.md

@@ -22,9 +22,11 @@ la configuration devrait être faite automatiquement. Si vous utilisez votre pro
 domaine via l'interface de votre registrar.
 
 ## Configuration DNS recommandée
-_NB : les exemples utilisent ici le texte `votre.domaine.tld`, à remplacer par votre propre domaine (par exemple `www.yunohost.org`)._
+
+*NB : les exemples utilisent ici le texte `votre.domaine.tld`, à remplacer par votre propre domaine (par exemple `www.yunohost.org`).*
 
 YunoHost fournit une configuration DNS recommandée, accessible via :
+
 - la webadmin, dans Domaines > votre.domain.tld > Configuration DNS ;
 - ou la ligne de commande, `yunohost domain dns-conf votre.domaine.tld`
 
@@ -84,7 +86,7 @@ suivante :
 |   TXT   |  mail._domainkey       |  `"v=DKIM1; k=rsa; p=uneGrannnndeClef"`                |
 |   TXT   |  _dmarc                |  `"v=DMARC1; p=none"`                                  |
 
-#### Quelques notes à propos de cette table
+### Quelques notes à propos de cette table
 
 - Tous ces enregistrements ne sont pas nécessaires. Pour une installation minimale, seuls les enregistrements en gras sont nécessaires ;
 - Le point à la fin de `votre.domaine.tld.` est important ;) ;
@@ -92,7 +94,7 @@ suivante :
 - Les valeurs montrées ici sont des valeurs d'exemple ! Référez-vous à la configuration générée chez vous pour savoir quelles valeurs utiliser ;
 - Nous recommandons un [TTL](https://fr.wikipedia.org/wiki/Time_to_Live#Le_Time_to_Live_dans_le_DNS) de 3600 (1 heure). Mais vous pouvez utiliser une autre valeur si vous savez ce que vous faîtes ;
 - Ne mettez pas d'enregistrement IPv6 si vous n'êtes pas certain que l'IPv6 fonctionne sur votre serveur ! Vous aurez des problèmes avec Let's Encrypt si ce n'est pas le cas.
-- Si vous utilisez le registrar Namecheap, les entrées SRV sont formattées comme **Service**: _xmpp-client **Protocol**: _tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: votre.domaine.tld
+- Si vous utilisez le registrar Namecheap, les entrées SRV sont formattées comme **Service**: `_xmpp-client` **Protocol**: `_tcp` **Priority**: `0` **Weight**: `5` **Port**: `5222` **Target**: `votre.domaine.tld`
 
 ### Résolution DNS inverse
 
@@ -108,8 +110,8 @@ Cela signifie que si votre adresse IPv4 publique est `111.222.333.444` et que
 votre nom de domaine est `domain.tld`, vous devez obtenir le résultat suivant
 en utilisant la commande `nslookup` :
 
-```shell
+```bash
-$ nslookup 111.222.333.444
+nslookup 111.222.333.444
 444.333.222.111.in-addr.arpa    name = domain.tld.
 ```
 

pages/02.administer/10.install/20.dns_config/dns_config.md

@@ -24,6 +24,7 @@ interface.
 NB: Examples here use the placeholder `your.domain.tld`, you have to replace it with your real domain, such as `www.yunohost.org`.
 
 YunoHost provides a recommended DNS configuration, available via:
+
 - the webadmin, in Domain > your.domain.tld > DNS configuration;
 - or the command line, `yunohost domain dns-conf your.domain.tld`
 
@@ -65,7 +66,6 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
 
 Though it might be easier to understand it if displayed like this:
 
-
 | Type    | Name                   | Value                                                 |
 | :-----: | :--------------------: | :--------------------------------------------------:  |
 |  **A**  |   **@**                |  `111.222.333.444` (your IPv4)                        |
@@ -83,7 +83,7 @@ Though it might be easier to understand it if displayed like this:
 |   TXT   |  mail._domainkey       |  `"v=DKIM1; k=rsa; p=someHuuuuuuugeKey"`              |
 |   TXT   |  _dmarc                |  `"v=DMARC1; p=none"`                                 |
 
-#### A few notes about this table
+### A few notes about this table
 
 - Not all these lines are absolutely necessary. For a minimal setup, you only need the records in bold.
 - The dot at the end of `your.domain.tld.` is important ;);
@@ -91,7 +91,7 @@ Though it might be easier to understand it if displayed like this:
 - These are example values ! See your generated conf for the actual values you should use;
 - We recommend a [TTL](https://en.wikipedia.org/wiki/Time_to_live#DNS_records) of 3600 (1 hour). But you can use something else if you know what you're doing;
 - Don't put an IPv6 record if you're not sure IPv6 really works on your server! You might have issues with Let's Encrypt if it doesn't.
-- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: _xmpp-client **Protocol**: _tcp **Priority**: 0 **Weight**: 5 **Port**: 5222 **Target**: your.domain.tld
+- If you're using the domain provider Namecheap the SRV DNS entries are formatted as **Service**: `_xmpp-client` **Protocol**: `_tcp` **Priority**: `0` **Weight**: `5` **Port**: `5222` **Target**: `your.domain.tld`
 
 ### Reverse DNS
 
@@ -106,8 +106,8 @@ If your public IPv4 address is `111.222.333.444` and your DNS
 domain is `domain.tld`, you should get following answer when using `nslookup`
 command tool:
 
-```shell
+```bash
-$ nslookup 111.222.333.444
+nslookup 111.222.333.444
 444.333.222.111.in-addr.arpa    name = domain.tld.
 ```
 

pages/02.administer/10.install/20.dns_config/dns_config.ru.md

@@ -24,6 +24,7 @@ DNS (система доменных имен) - это система, кото
 ПРИМЕЧАНИЕ: В примерах здесь используется заполнитель `your.domain.tld`, вы должны заменить его своим реальным доменом, например `www.yunohost.org`.
 
 YunoHost предоставляет рекомендуемую конфигурацию DNS, доступную через:
+
 - веб-администратор, Домены > `your.domain.tld` > DNS;
 - или в командной строке: `yunohost domain dns-conf your.domain.tld`
 
@@ -65,7 +66,6 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
 
 Хотя, возможно, было бы легче понять это, если бы оно отображалось следующим образом:
 
-
 | Тип    | Название                   | Значение                                                 |
 | :-----: | :--------------------: | :--------------------------------------------------:  |
 |  **A**  |   **@**                |  `111.222.333.444` (ваш IPv4)                        |
@@ -83,7 +83,7 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
 |   TXT   |  mail._domainkey       |  `"v=DKIM1; k=rsa; p=someHuuuuuuugeKey"`              |
 |   TXT   |  _dmarc                |  `"v=DMARC1; p=none"`                                 |
 
-#### Несколько замечаний по поводу этой таблицы
+### Несколько замечаний по поводу этой таблицы
 
 - Не все эти строки абсолютно необходимы. Для минимальной настройки вам понадобятся только записи, выделенные жирным шрифтом.
 - Точка в конце `ваш.домен.tld.` важна ;);
@@ -91,7 +91,7 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
 - Это примерные значения! Смотрите сгенерированный вами conf для получения фактических значений, которые вы должны использовать;
 - Мы рекомендуем использовать [TTL](https://en.wikipedia.org/wiki/Time_to_live#DNS_records ) 3600 (1 час). Но вы можете использовать что-то еще, если знаете, что делаете;
 - Не размещайте запись IPv6, если вы не уверены, что IPv6 действительно работает на вашем сервере! У вас могут возникнуть проблемы с Let's Encrypt, если это не так.
-- Если вы используете Namecheap поставщика домена, записи SRV DNS форматируются как **Сервис**: _xmpp-client **Протокол**: _tcp **Приоритет**: 0 **Вес**: 5 **Порт**: 5222 **Цель**: your.domain.tld
+- Если вы используете Namecheap поставщика домена, записи SRV DNS форматируются как **Сервис**: `_xmpp-client` **Протокол**: `_tcp` **Приоритет**: `0` **Вес**: `5` **Порт**: `5222` **Цель**: `your.domain.tld`
 
 ### Обратный DNS
 
@@ -106,8 +106,8 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
 -домен - `domain.tld`, вы должны получить следующий ответ при использовании
 командной строки `nslookup`:
 
-```shell
+```bash
-$ nslookup 111.222.333.444
+nslookup 111.222.333.444
 444.333.222.111.in-addr.arpa    name = domain.tld.
 ```
 

pages/02.administer/10.install/25.installing_debian/installing_debian.md

@@ -7,36 +7,36 @@ routes:
   default: '/installing_debian'
 ---
 
-If you can't install Yunohost successfully, there's always the option to install Debian and then install Yunohost on top.
+If you can't install YunoHost successfully, there's always the option to install Debian and then install YunoHost on top.
 
 ## Which Debian version
 
-At the time of writing, only Debian 11 is supported by Yunohost. Don't use Debian 12.
+At the time of writing, only Debian 11 is supported by YunoHost. Don't use Debian 12.
 
 ## Before you start
 
-The Debian installer isn't the easiest Linux installer, especially for beginners. It'll be easier to **format the hard drive** you plan to use for Debian+Yunohost **before you install Debian**, using your disk utility of choice.
+The Debian installer isn't the easiest Linux installer, especially for beginners. It'll be easier to **format the hard drive** you plan to use for Debian+YunoHost **before you install Debian**, using your disk utility of choice.
 
 ## Installing Debian
 
 ### Booting the installer
 
-This guide won't go into details on how to boot the Debian installer. You can use Debian's own documentation for that. The short version is you'll need to flash a USB stick with the Debian 11 image, like you would flash the Yunohost image.
+This guide won't go into details on how to boot the Debian installer. You can use Debian's own documentation for that. The short version is you'll need to flash a USB stick with the Debian 11 image, like you would flash the YunoHost image.
 
 ### Installing
 
 In general, you can simply follow the instructions on screen and use the suggested defaults.
 
-Debian installer will ask for a **hostname** and a **domain name**. You can use “yunohost” and “yunohost.local”. It’s not really important since the Yunohost Installer will overwrite those anyway.
+Debian installer will ask for a **hostname** and a **domain name**. You can use `yunohost` and `yunohost.local`. It’s not really important since the YunoHost Installer will overwrite those anyway.
 
 Debian will ask for a **root password**. Make sure you pick a **really long and complex** one and save it to your password manager of choice (Bitwarden, Firefox, etc…) or write it somewhere safe. Remember that this is a server that  will be available on the internet, making it vulnerable to possible attacks so you should be extra safe here!
 
-The installer will also ask for a **user account** and another password. **Important:** name it something that won’t be used by your Yunohost server later. For example, you can name it `debian`. Be sure to also use a long complex password.
+The installer will also ask for a **user account** and another password. **Important:** name it something that won’t be used by your YunoHost server later. For example, you can name it `debian`. Be sure to also use a long complex password.
 
 When the install asks about where to install and how to **create disk partitions**, select the option to use the whole disk, unless you know what you're doing.
 
 - Don’t separate the /home, /var or /tmp partitions. Use the option to “keep all files in one partition”.
-- Don’t encrypt any partitions, [as recommended](https://yunohost.org/en/administer/install/hardware:regular#about-encryption))
+- Don’t encrypt any partitions, [as recommended](https://yunohost.org/en/administer/install/hardware:regular#about-encryption)
 
 The installer will ask about **mirrors**. Select a country and server close to your location, or use the default options.
 
@@ -51,5 +51,5 @@ The installer will ask about which **desktop environment** you want. You should
 2. Reboot
 3. Login as `root` with the long complex password you created earlier.
 4. Install curl by typing `apt install curl`
-5. Proceed to install Yunohost on Debian using these instructions: https://yunohost.org/en/install/hardware:vps_debian
+5. Proceed to install YunoHost on Debian using these instructions: <https://yunohost.org/en/install/hardware:vps_debian>
    - The installer will ask for permission to overwrite some configuration files. Select Yes.

pages/02.administer/10.install/install.de.md

@@ -132,57 +132,56 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
 
 [/div]
 
-
 {% if hardware != '' %}
 
 {% if wsl %}
 !! Dieses Setup ist vorwiegend für lokales Testing durch fortgeschrittene Benutzer gedacht. Aufgrund Limitierungen auf WSL Seite (insbesondere veränderliche IP Adresse), selfhosting kann damit knifflig sein und wird hier nicht weiter beschrieben.
 {% endif %}
 
-
 ## [fa=list-alt /] Pre-requisites
 
 {% if regular %}
-* Eine x86-kompatible für YunoHost bestimmte (dedizierte) Hardware: Laptop, Nettop, Netbook, Desktop mit 512MB RAM und 16GB Speicherkapazität (Minimum)
+
+- Eine x86-kompatible für YunoHost bestimmte (dedizierte) Hardware: Laptop, Nettop, Netbook, Desktop mit 512MB RAM und 16GB Speicherkapazität (Minimum)
 {% elseif rpi34 %}
-* Ein Raspberry Pi 3 oder 4
+- Ein Raspberry Pi 3 oder 4
 {% elseif rpi012 %}
-* Ein Raspberry Pi 0, 1 oder 2 mit mindestens 512MB RAM 
+- Ein Raspberry Pi 0, 1 oder 2 mit mindestens 512MB RAM
 {% elseif internetcube %}
-* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2
+- Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2
-* Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei
+- Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei
 {% elseif arm_sup %}
-* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2
+- Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2
 {% elseif arm_unsup %}
-* Ein ARM Board mit mindestens 512MB RAM
+- Ein ARM Board mit mindestens 512MB RAM
 {% elseif vps_debian %}
-* Ein dedizierter oder Virtual Private Server mit Debian 11 (Bullseye) <small>(mit **kernel >= 3.12**)</small> vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum)
+- Ein dedizierter oder Virtual Private Server mit Debian 11 (Bullseye) <small>(mit **kernel >= 3.12**)</small> vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum)
 {% elseif vps_ynh %}
-* Ein dedizierter oder Virtual Private Server mit YunoHost vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum)
+- Ein dedizierter oder Virtual Private Server mit YunoHost vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum)
 {% elseif virtualbox %}
-* Ein x86 Computer mit [VirtualBox installiert](https://www.virtualbox.org/wiki/Downloads) und ausreichend Arbeitsspeicherkapazität (RAM), um eine kleine virtuelle Maschine mit 1024MB RAM und 8GB Speicherkapazität (Minimum) betreiben zu können
+- Ein x86 Computer mit [VirtualBox installiert](https://www.virtualbox.org/wiki/Downloads) und ausreichend Arbeitsspeicherkapazität (RAM), um eine kleine virtuelle Maschine mit 1024MB RAM und 8GB Speicherkapazität (Minimum) betreiben zu können
 {% endif %}
 {% if arm %}
-* Eine Spannungsversorung (entweder ein Netzteil oder ein MicroUSB Kabel) für dein Board;
+- Eine Spannungsversorung (entweder ein Netzteil oder ein MicroUSB Kabel) für dein Board;
-* Eine microSD Karte: 16GB Speicherkapazität (Minimum), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) nachdrücklich empfohlen (so wie [diese SanDisk A1 Karte](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/));
+- Eine microSD Karte: 16GB Speicherkapazität (Minimum), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) nachdrücklich empfohlen (so wie [diese SanDisk A1 Karte](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/));
 {% endif %}
 {% if regular %}
-* Ein USB Stick mit mindestens 1GB Speicherkapazität ODER einem Standard CD-Rohling
+- Ein USB Stick mit mindestens 1GB Speicherkapazität ODER einem Standard CD-Rohling
 {% endif %}
 {% if wsl %}
-* Windows 10 und neuer
+- Windows 10 und neuer
-* Administrator Rechte
+- Administrator Rechte
-* Windows Subsystem for Linux, aus dem Optional Features Menü von Windows installiert
+- Windows Subsystem for Linux, aus dem Optional Features Menü von Windows installiert
-* *Empfohlen:* Windows Command Prompt App, aus dem Microsoft Store installiert. Viel besser als der Standard Terminal, weil sie Shortcuts für WSL distros bietet.
+- *Empfohlen:* Windows Command Prompt App, aus dem Microsoft Store installiert. Viel besser als der Standard Terminal, weil sie Shortcuts für WSL distros bietet.
 {% endif %}
 {% if at_home %}
-* Ein [vernünftiger ISP](/isp), vorzugsweise mit einer guten und unbegrenzten Upstream Bandbreite
+- Ein [vernünftiger ISP](/isp), vorzugsweise mit einer guten und unbegrenzten Upstream Bandbreite
 {% if not virtualbox %}
-* Ein Ethernet Kabel (RJ-45), um deinen Server mit deinem Router zu verbinden. {% if rpi012 %} (Oder, für Rasperry Pi Zero : und USB OTG oder ein Wifi Dongle) {% endif %}
+- Ein Ethernet Kabel (RJ-45), um deinen Server mit deinem Router zu verbinden. {% if rpi012 %} (Oder, für Rasperry Pi Zero : und USB OTG oder ein Wifi Dongle) {% endif %}
 {% endif %}
-* Ein Computer, um diese Anleitung zu lesen, das Image zu flashen und auf deinen Server zuzugreifen.
+- Ein Computer, um diese Anleitung zu lesen, das Image zu flashen und auf deinen Server zuzugreifen.
 {% else %}
-* Ein Computer oder ein Smartphone, um diese Anleitung zu lesen und auf deinen Server zuzugreifen.
+- Ein Computer oder ein Smartphone, um diese Anleitung zu lesen und auf deinen Server zuzugreifen.
 {% endif %}
 
 {% if virtualbox %}
@@ -190,7 +189,9 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
 {% endif %}
 
 {% if wsl %}
+
 ## Vorstellung
+
 WSL ist ein cooles Windows 10 Feature, das Linux pseudo-Distributionen durch die Kommandozeile verfügbar macht. Lass es uns pseudo nennen, weil auch obwohl sie nicht wirklich wie virtuelle Maschinen sind, sind sie auf Virtualisierungskapazitäten angewiesen, die deren Integration mit Windows fast nahtlos machen.
 So kann z.B. Docker für Windows jetzt auf WSL bauen, anstatt auf Hyper-V.
 
@@ -225,11 +226,12 @@ sudo apt update
 sudo apt upgrade
 sudo apt dist-upgrade
 ```
+
 ## Verhindern, dass WSL an Konfigurationsdateien herumfeilt
 
 Bearbeite `/etc/wsl.conf` und füge den folgenden Code darin ein:
 
-```
+```text
 [network]
 generateHosts = false
 generateResolvConf = false
@@ -252,6 +254,7 @@ Unter WSL fehlt Debian `systemd`, eine Service-Konfigurations-Software.
 Diese ist ein Schlüsselelement für YunoHost, und für jede anständige Debian Distro (also ernsthaft Microsoft, was zum Henker). Lass es uns installieren:
 
 1. Installation der dotNET Runtime:
+
 ```bash
 # In WSL
 wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@@ -263,6 +266,7 @@ sudo apt install -y dotnet-sdk-3.1
 ```
 
 2. Installation von [Genie](https://github.com/arkane-systems/genie):
+
 ```bash
 # In WSL
 # Das repository hinzufügen
@@ -292,25 +296,28 @@ Rufe `genie -s` immer während des Startes deiner Distro auf.
 `wsl -d YunoHost -e genie -s`
 
 ## Backup und Wiederherstellung der Distro
+
 ### Mache dein erstes Distro Backup
+
 Wie zuvor gesagt, gibt es keine Rollback Möglichkeit. Lass uns deshal deine frische Distro exportieren. In PowerShell:
 
-```
+```bash
 cd ~
 wsl --export YunoHost .\WSL\YunoHost.tar.gz
 ```
 
 ### Im Falle eines Crash, lösche und stelle die gesamte Distro wieder her
 
-```
+```bash
 cd ~
 wsl --unregister YunoHost
 wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
 ```
+
 {% endif %}
 
-
 {% if vps_ynh %}
+
 ## YunoHost VPS Provider
 
 Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen :
@@ -329,8 +336,8 @@ Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen :
 [/div]
 {% endif %}
 
-
 {% if at_home %}
+
 ## [fa=download /] Lade das {{image_type}} Image herunter
 
 {% if rpi012 %}
@@ -413,17 +420,16 @@ $(document).ready(function () {
 });
 </script>
 
-
-
-
-
-
 {% if not virtualbox %}
 
 {% if arm %}
+
 ## ![microSD Karte mit Adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash das {{image_type}} Image
+
 {% else %}
+
 ## ![USB Stick](image://usb_key.png?resize=100,100&class=inline) Flash das YunoHost Image
+
 {% endif %}
 
 Jetzt wo du das Image von {{image_type}} heruntergeladen hast, solltest du es auf {% if arm %}einer microSD Karte{% else %}einem USB stick oder einer CD/DVD flashen.{% endif %}
@@ -457,16 +463,17 @@ Führe dann Folgendes aus :
 # Ersetze /dev/mmcblk0 durch das richtige Device, wenn der Name deines Device anders ist...
 dd if=/path/to/yunohost.img of=/dev/mmcblk0
 ```
+
 [/ui-tab]
 {% if regular %}
 [ui-tab title="Eine CD/DVD brennen"]
 Für ältere Geräte könntest du eine CD/DVD brennen wollen. Die zu verwendende Software hängt von deinem Betriebssystem ab.
 
-* Auf Windows, benutze [ImgBurn](http://www.imgburn.com/), um die Image Datei auf die Disc zu schreiben.
+- Auf Windows, benutze [ImgBurn](http://www.imgburn.com/), um die Image Datei auf die Disc zu schreiben.
 
-* Auf macOS, benutze [Disk Utility](http://support.apple.com/kb/ph7025)
+- Auf macOS, benutze [Disk Utility](http://support.apple.com/kb/ph7025)
 
-* Auf GNU/Linux hat man eine große Auswahl, wie [Brasero](https://wiki.gnome.org/Apps/Brasero) oder [K3b](http://www.k3b.org/)
+- Auf GNU/Linux hat man eine große Auswahl, wie [Brasero](https://wiki.gnome.org/Apps/Brasero) oder [K3b](http://www.k3b.org/)
 [/ui-tab]
 {% endif %}
 [/ui-tabs]
@@ -485,34 +492,28 @@ Für ältere Geräte könntest du eine CD/DVD brennen wollen. Die zu verwendende
 
 Gehe zu **Settings** > **Network**:
 
-* Wähle `Bridged adapter`
+- Wähle `Bridged adapter`
-* Wähle den Namen deines Interface:
+- Wähle den Namen deines Interface:
     **wlan0**, wenn du kabellos verbunden bist, oder andernfalls **eth0**.
 
 ![](image://virtualbox_2.png?class=inline)
 
 {% endif %}
 
-
-
-
-
-
-
-
-
 {% if arm %}
+
 ## [fa=plug /] Das Board einschalten
 
-* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
+- Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
-    * Fortgeschrittene Nutzer, die das Board konfigurieren möchten, um sich stattdessen per WiFi zu verbinden, können bspw. [hier](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md) nachlesen.
+  - Fortgeschrittene Nutzer, die das Board konfigurieren möchten, um sich stattdessen per WiFi zu verbinden, können bspw. [hier](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md) nachlesen.
-* Stecke die SD Karte in dein Board.
+- Stecke die SD Karte in dein Board.
-* (Optional) Du kannst Bildschirm+Tastatur direkt an deinem Board anschließen, wenn du Fehler am Boot Prozess beheben willst oder wenn du dich wohler fühlst zu "sehen was passiert" oder du direkten Zugriff auf das Board haben willst.
+- (Optional) Du kannst Bildschirm+Tastatur direkt an deinem Board anschließen, wenn du Fehler am Boot Prozess beheben willst oder wenn du dich wohler fühlst zu "sehen was passiert" oder du direkten Zugriff auf das Board haben willst.
-* Schalte das Board ein.
+- Schalte das Board ein.
-* Warte ein paar Minuten während sich das Board beim ersten Boot automatisch selbst konfiguriert.
+- Warte ein paar Minuten während sich das Board beim ersten Boot automatisch selbst konfiguriert.
-* Stelle sicher, dass dein Computer (Desktop/Laptop) mit dem selben lokalen Netzwerk verbunden ist (z.B. mit der selben Internet Box) wie dein Server.
+- Stelle sicher, dass dein Computer (Desktop/Laptop) mit dem selben lokalen Netzwerk verbunden ist (z.B. mit der selben Internet Box) wie dein Server.
 
 {% elseif virtualbox %}
+
 ## [fa=plug /] Die virtuelle Maschine hochfahren
 
 Starte die virtuelle Maschine nach der Auswahl des YunoHost Image.
@@ -521,17 +522,18 @@ Starte die virtuelle Maschine nach der Auswahl des YunoHost Image.
 
 ! Wenn du an den Fehler "VT-x ist nicht erreichbar" gerätst, musst du wahrscheinlich Virtualisierung im BIOS deines Computers einschalten.
 
-
 {% else %}
+
 ## [fa=plug /] Die Maschine von deinem USB Stick booten
 
-* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
+- Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
-* Fahre deinen Server mit dem USB Stick oder einer eingesteckten CD-ROM hoch und wähle es durch Drücken einer der folgenden (Hardware spezifischen) Tasten als **bootable device** aus:
+- Fahre deinen Server mit dem USB Stick oder einer eingesteckten CD-ROM hoch und wähle es durch Drücken einer der folgenden (Hardware spezifischen) Tasten als **bootable device** aus:
 `<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` oder `<DEL>`.
-    * Anmerkung: Wenn auf dem Server zuvor eine aktuelle Windows Version (8+) installiert war, musst du Windows zuerst "actually reboot" sagen. Das kann irgendwo in "Advanced startup options" gemacht werden.
+  - Anmerkung: Wenn auf dem Server zuvor eine aktuelle Windows Version (8+) installiert war, musst du Windows zuerst "actually reboot" sagen. Das kann irgendwo in "Advanced startup options" gemacht werden.
 {% endif %}
 
 {% if regular or virtualbox %}
+
 ## [fa=rocket /] Die grafische Installation starten
 
 Du solltest einen Bildschirm wie diesen sehen:
@@ -556,7 +558,8 @@ Das YunoHost-Projekt hat die klassische Installation so weit wie möglich verein
 
 Mit der Installation im Expertenmodus hast du mehr Möglichkeiten, insbesondere was die genaue Partitionierung deiner Speichermedien betrifft. Du kannst dich auch für den klassischen Modus entscheiden und [deine Festplatten anschließend hinzufügen](/external_storage).
 
-### Zusammenfassung der Schritte im Expertenmodus:
+### Zusammenfassung der Schritte im Expertenmodus
+
   1. Wähle `Expert graphical install` aus.
   2. Wähle deine Sprache, deinen Standort, dein Tastaturlayout und möglicherweise deine Zeitzone aus.
   3. Partitioniere deine Festplatten. Hier kanst du ein RAID einrichten oder den Server ganz oder teilweise verschlüsseln.
@@ -577,38 +580,45 @@ Wenn du über eine oder mehrere Festplatten zum Speichern von Daten verfügst, k
 | `/home/yunohost.backup/archives` | YunoHost-Backups, die idealerweise an anderer Stelle als auf den Datenträgern platziert werden, auf denen die Daten verwaltet werden |
 | `/home/yunohost.app` | Umfangreiche Datenmengen aus YunoHost Apps (nextcloud, matrix...) |
 | `/home/yunohost.multimedia` | Große Datenmenge, die von mehreren Anwendungen gemeinsam genutzt wird |
-| `/var/mail` | User mail
+| `/var/mail` | User mail |
 
 Wenn du Flexibilität haben möchtest und die Größe von Partitionen nicht (verändern) möchtest, kannst du dich auch dafür entscheiden, auf `/mnt/hdd` zu mounten und dieser [Anleitung zum Mounten aller dieser Ordner mit `mount --bind`](/external_storage) zu folgen.
 
 ### Über Verschlüsselung
+
 Beachte: Wenn du deine Festplatten ganz oder teilweise verschlüsselst, musst du bei jedem Neustart deines Servers die Passphrase eingeben. Das kann ein Problem darstellen, wenn du nicht vor Ort bist. Es gibt jedoch (ziemlich schwierig zu implementierende) Lösungen, die es dir ermöglichen, die Passphrase über SSH oder über eine Webseite einzugeben (suche nach "Dropbear Encrypted Disk").
 
 ### Über RAID
+
 Denk daran, dass:
- * die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt).
+
- * ein RAID 1 (auch ohne Ersatz) aus Wahrscheinlichkeitssicht zuverlässiger als ein RAID 5 ist.
+- die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt).
- * und Hardware-Raids von der Raid-Karte abhängen. Wenn die Karte ausfällt, benötigst du einen Ersatz, um das Array zu lesen und neu aufzubauen.
+- ein RAID 1 (auch ohne Ersatz) aus Wahrscheinlichkeitssicht zuverlässiger als ein RAID 5 ist.
+- und Hardware-Raids von der Raid-Karte abhängen. Wenn die Karte ausfällt, benötigst du einen Ersatz, um das Array zu lesen und neu aufzubauen.
 
 [/ui-tab]
 [/ui-tabs]
 {% endif %}
 
-
 {% if rpi012 %}
+
 ## [fa=bug /] Mit dem Board verbinden und das Image per Hotfix reparieren
+
 Raspberry Pi 1 und 0 werden aufgrund von [Kompilierungsproblemen für diese Architektur](https://github.com/YunoHost/issues/issues/1423) nicht vollständig unterstützt.
 
 Es ist jedoch möglich, das Image selbst zu reparieren, bevor du die Erstkonfiguration ausführst.
 
-Um das zu erreichen, musst du dich auf deinem Raspberry Pi als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort „yunohost“ verbinden:
+Um das zu erreichen, musst du dich auf deinem Raspberry Pi als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort `yunohost` verbinden:
-```
+
+```bash
 ssh root@yunohost.local
 ```
-(oder „yunohost-2.local“ usw., wenn sich mehrere YunoHost-Server in deinem Netzwerk befinden)
+
+(oder `yunohost-2.local` usw., wenn sich mehrere YunoHost-Server in deinem Netzwerk befinden)
 
 Führe dann die folgenden Befehle aus, um das Metronomproblem zu umgehen:
-```
+
+```bash
 mv /usr/bin/metronome{,.bkp}   
 mv /usr/bin/metronomectl{,.bkp} 
 ln -s /usr/bin/true /usr/bin/metronome
@@ -616,18 +626,20 @@ ln -s /usr/bin/true /usr/bin/metronomectl
 ```
 
 Und diesen hier, um das UpnPC-Problem zu umgehen:
-```
+
+```bash
 sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
 ```
 
-! Der letzte Befehl muss nach jedem Yunohost-Upgrade ausgeführt werden :/
+! Der letzte Befehl muss nach jedem YunoHost-Upgrade ausgeführt werden :/
 
 {% elseif arm_unsup %}
+
 ## [fa=terminal /] Verbindung zum Board
 
 Als nächstes musst du [die lokale IP-Adresse deines Servers finden](/finding_the_local_ip), um dich als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort `1234` zu verbinden.
 
-```
+```bash
 ssh root@192.168.x.xxx
 ```
 
@@ -635,8 +647,8 @@ ssh root@192.168.x.xxx
 
 {% endif %}
 
-
 {% if vps_debian or arm_unsup %}
+
 ## [fa=rocket /] Das Installationsskript ausführen
 
 - Öffne eine Kommandozeile auf deinem Server (entweder direkt oder [über SSH](/ssh))
@@ -692,15 +704,15 @@ Du kannst die Post-Installation auch mit dem Befehl `yunohost tools postinstall`
 
 {% if not internetcube %}
 
-##### [fa=globe /] Haupt-Domain
+### [fa=globe /] Haupt-Domain
 
 Dies ist die Domäne, über die die Benutzer deines Servers auf das **Authentifizierungsportal** zugreifen. Du kannst später weitere Domains hinzufügen und bei Bedarf ändern, welche Domain die Haupt-Domain ist.
 
 {% if not wsl %}
 
-* Wenn du neu im Self-Hosting bist und noch keinen Domain-Namen hast, empfehlen wir die Verwendung eines **.nohost.me** / **.noho.st** / **.ynh.fr** (z.B. `homersimpson.nohost.me`). Sofern die Domain noch nicht vergeben ist, wird sie automatisch konfiguriert und du benötigst keinen weiteren Konfigurationsschritt. Bitte beachte, dass der Nachteil darin besteht, dass du nicht die vollständige Kontrolle über die DNS-Konfiguration hast.
+- Wenn du neu im Self-Hosting bist und noch keinen Domain-Namen hast, empfehlen wir die Verwendung eines **.nohost.me** / **.noho.st** / **.ynh.fr** (z.B. `homersimpson.nohost.me`). Sofern die Domain noch nicht vergeben ist, wird sie automatisch konfiguriert und du benötigst keinen weiteren Konfigurationsschritt. Bitte beachte, dass der Nachteil darin besteht, dass du nicht die vollständige Kontrolle über die DNS-Konfiguration hast.
 
-* Wenn du bereits einen Domain-Namen besitzt, möchtest du ihn wahrscheinlich hier verwenden. Später musst du DNS-Einträge konfigurieren, so wie [hier](/dns_config) beschrieben.
+- Wenn du bereits einen Domain-Namen besitzt, möchtest du ihn wahrscheinlich hier verwenden. Später musst du DNS-Einträge konfigurieren, so wie [hier](/dns_config) beschrieben.
 
 !!! Ja, du *musst* eine Domain-Namen konfigurieren. Wenn du keinen Domain-Namen hast und auch keine **.nohost.me** / **.noho.st** / **.ynh.fr** möchtest, kannst du eine Dummy-Domain einrichten wie `yolo.test` und passt deine **lokale** `/etc/hosts` Datei so an, dass diese Dummy-Domain [auf die entsprechende IP verweist, wie hier erklärt](/dns_local_network).
 
@@ -711,25 +723,24 @@ Zum Beispiel `ynh.wsl`. Der schwierige Teil besteht darin, diese Domain bei dein
 
 Ändere deine `C:\Windows\System32\drivers\etc\hosts` Datei. Du solltest eine Zeile haben, die mit `::1` beginnt. Aktualisiere sie oder füge sie bei Bedarf hinzu, um Folgendes zu erhalten:
 
-```
+```text
 ::1    ynh.wsl localhost
 ```
 
 Wenn du Subdomains erstellen möchtest, denk daran, diese auch in der Datei `hosts` hinzuzufügen:
 
-```
+```text
 ::1    ynh.wsl subdomain.ynh.wsl localhost
 ```
 
 {% endif %}
 
-##### [fa=key /] Der erste Benutzer
+### [fa=key /] Der erste Benutzer
 
 [Seit YunoHost 11.1](https://forum.yunohost.org/t/yunohost-11-1-release-sortie-de-yunohost-11-1/23378) wird in dieser Phase der erste Benutzer erstellt. Du solltest einen Benutzernamen und ein einigermaßen komplexes Passwort wählen. (Wir können nicht genug betonen, dass das Passwort **robust** sein sollte!) Dieser Benutzer wird der Administratoren-Gruppe hinzugefügt und kann daher auf das Benutzerportal und die Webadministrationsoberfläche zugreifen und eine Verbindung  [über **SSH**](/ssh) oder [**SFTP**](/filezilla) herstellen. Administratoren erhalten außerdem E-Mails an `root@yourdomain.tld` und `admin@yourdomain.tld`: Diese E-Mails können zum Versenden technischer Informationen oder Warnungen verwendet werden. Du kannst später weitere Benutzer hinzufügen, die du auch zur Administratoren-Gruppe hinzufügen kannst.
 
 Dieser Benutzer ersetzt den alten `admin` Benutzer, auf den sich einige alte Dokumentationsseiten möglicherweise noch beziehen. In diesem Fall: Ersetzen Sie einfach `admin` durch Ihren Benutzernamen.
 
-
 ## [fa=stethoscope /] Die Erstdiagnose durchführen
 
 Sobald die Post-Installation abgeschlossen ist, solltest du dich tatsächlich mit den Credentials des ersten Benutzers, den du gerade erstellt hast, bei der Webadministrationsoberfläche anmelden können.
@@ -747,7 +758,6 @@ Das Diagnosesystem soll eine einfache Möglichkeit bieten, zu überprüfen, ob a
 
 !!! Ist eine Warnung für dich nicht relevant (z.B. weil du nicht vor hast, eine bestimmte Funktion zu verwenden), ist es völlig in Ordnung, das Problem als 'ignoriert' zu markieren, indem du im Webadmin > Diagnose auf den "Ignorieren" Button (für diese bestimmte Funktion) klickst.
 
-
 [ui-tabs position="top-left" active="0" theme="lite"]
 [ui-tab title="(Empfohlen) Über die Weboberfläche"]
 Um eine Diagnose auszuführen, gehe im Web Admin auf den Abschnitt "Diagnose". Klicke auf "Erstdiagnose ausführen". Du solltest nun einen Bildschirm wie diesen erhalten:
@@ -758,10 +768,12 @@ Um eine Diagnose auszuführen, gehe im Web Admin auf den Abschnitt "Diagnose". K
 
 [/ui-tab]
 [ui-tab title="In der Kommandozeile"]
-```
+
+```bash
 yunohost diagnosis run
 yunohost diagnosis show --issues --human-readable
 ```
+
 [/ui-tab]
 [/ui-tabs]
 
@@ -782,9 +794,11 @@ Gehe zu Domains > Klicke auf deine Domain > SSL Zertifikat
 
 [/ui-tab]
 [ui-tab title="In der Kommandozeile"]
-```
+
+```bash
 yunohost domain cert install
 ```
+
 [/ui-tab]
 [/ui-tabs]
 

pages/02.administer/10.install/install.fr.md

@@ -126,56 +126,54 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
 
 [/div]
 
-
 {% if hardware != '' %}
 
 ## [fa=list-alt /] Pré-requis
 
 {% if regular %}
-* Un matériel compatible x86 dédié à YunoHost : portable, netbook, ordinateur avec 512Mo de RAM et 16Go de capacité de stockage (au moins) ;
+
+- Un matériel compatible x86 dédié à YunoHost : portable, netbook, ordinateur avec 512Mo de RAM et 16Go de capacité de stockage (au moins) ;
 {% elseif rpi34 %}
-* Un Raspberry Pi 3 ou 4 ;
+- Un Raspberry Pi 3 ou 4 ;
 {% elseif rpi012 %}
-* Un Raspberry Pi 0, 1 ou 2 avec au moins 512Mo de RAM ;
+- Un Raspberry Pi 0, 1 ou 2 avec au moins 512Mo de RAM ;
 {% elseif internetcube %}
-* Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ;
+- Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ;
-* Un VPN avec une IP publique dédiée et un fichier `.cube` ;
+- Un VPN avec une IP publique dédiée et un fichier `.cube` ;
 {% elseif arm_sup %}
-* Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ;
+- Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ;
 {% elseif arm_unsup %}
-* Une carte ARM avec au moins 512Mo de RAM ;
+- Une carte ARM avec au moins 512Mo de RAM ;
 {% elseif vps_debian %}
-* Un serveur dédié ou virtuel avec Debian 11 (Bullseye) pré-installé <small>(avec un **kernel >= 3.12**)</small>, avec au moins 512Mo de RAM et 16Go de capacité de stockage ;
+- Un serveur dédié ou virtuel avec Debian 11 (Bullseye) pré-installé <small>(avec un **kernel >= 3.12**)</small>, avec au moins 512Mo de RAM et 16Go de capacité de stockage ;
 {% elseif vps_ynh %}
-* Un serveur dédié ou virtuel avec YunoHost pré-installé, avec au moins 512Mo de RAM et 16Go de capacité de stockage ;
+- Un serveur dédié ou virtuel avec YunoHost pré-installé, avec au moins 512Mo de RAM et 16Go de capacité de stockage ;
 {% elseif virtualbox %}
-* Un ordinateur x86 avec [VirtualBox installé](https://www.virtualbox.org/wiki/Downloads) et assez de RAM disponible pour lancer une petite machine virtuelle avec au moins 1024Mo de RAM et 8Go de capacité de stockage ;
+- Un ordinateur x86 avec [VirtualBox installé](https://www.virtualbox.org/wiki/Downloads) et assez de RAM disponible pour lancer une petite machine virtuelle avec au moins 1024Mo de RAM et 8Go de capacité de stockage ;
 {% endif %}
 {% if arm %}
-* Une alimentation électrique (soit un adaptateur, soit un câble microUSB) pour alimenter la carte ;
+- Une alimentation électrique (soit un adaptateur, soit un câble microUSB) pour alimenter la carte ;
-* Une carte microSD : au moins 16Go de capacité, [classe « A1 »](https://fr.wikipedia.org/wiki/Carte_SD#Vitesse) hautement recommandée (comme par exemple [cette carte SanDisk A1](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)) ;
+- Une carte microSD : au moins 16Go de capacité, [classe « A1 »](https://fr.wikipedia.org/wiki/Carte_SD#Vitesse) hautement recommandée (comme par exemple [cette carte SanDisk A1](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)) ;
 {% endif %}
 {% if regular %}
-* Une clé USB avec au moins 1Go de capacité OU un CD vierge standard ;
+- Une clé USB avec au moins 1Go de capacité OU un CD vierge standard ;
 {% endif %}
 {% if at_home %}
-* Un [fournisseur d'accès à Internet correct](/isp), de préférence avec une bonne vitesse d’upload ;
+- Un [fournisseur d'accès à Internet correct](/isp), de préférence avec une bonne vitesse d’upload ;
 {% if not virtualbox %}
-* Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet {% if rpi012 %} (Ou pour Rasperry Pi Zero : Un câble OTG ou un adaptateur Wifi USB) {% endif %} ;
+- Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet {% if rpi012 %} (Ou pour Rasperry Pi Zero : Un câble OTG ou un adaptateur Wifi USB) {% endif %} ;
 {% endif %}
-* Un ordinateur pour lire ce guide, flasher l'image et accéder à votre serveur.
+- Un ordinateur pour lire ce guide, flasher l'image et accéder à votre serveur.
 {% else %}
-* Un ordinateur ou un smartphone pour lire ce guide et accéder à votre serveur.
+- Un ordinateur ou un smartphone pour lire ce guide et accéder à votre serveur.
 {% endif %}
 
 {% if virtualbox %}
 ! N.B. : Installer YunoHost dans une VirtualBox est généralement destiné à tester la distribution ou pour développer. VirtualBox n'est pas pratique pour faire tourner un 'vrai' serveur sur le long terme car la machine surlaquelle il est installé ne sera sans doute pas allumé 24h/24, et parce que Virtualbox rajoute une couche de complexité supplémentaire pour ce qui est d'exposer la machine sur Internet.
 {% endif %}
 
-
-
-
 {% if vps_ynh %}
+
 ## Fournisseurs de VPS YunoHost
 
 Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
@@ -194,8 +192,8 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
 [/div]
 {% endif %}
 
-
 {% if at_home %}
+
 ## [fa=download /] Télécharger l'image {{image_type}}
 
 {% if rpi012 %}
@@ -278,17 +276,16 @@ $(document).ready(function () {
 });
 </script>
 
-
-
-
-
-
 {% if not virtualbox %}
 
 {% if arm %}
+
 ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flasher l'image {{image_type}}
+
 {% else %}
+
 ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flasher l'image YunoHost
+
 {% endif %}
 
 Maintenant que vous avez téléchargé l’image de {{image_type}}, vous devez la mettre sur {% if arm %}une carte microSD{% else %}une clé USB ou un CD/DVD.{% endif %}
@@ -328,23 +325,24 @@ dd if=/path/to/yunohost.img of=/dev/mmcblk0
 [ui-tab title="Copier un CD/DVD"]
 Pour les anciens matériels, il vous faut peut-être utiliser un CD/DVD. Le logiciel à utiliser est différent suivant votre système d’exploitation.
 
-* Sur Windows, utilisez [ImgBurn](http://www.imgburn.com/) pour écrire l’image sur le disque
+- Sur Windows, utilisez [ImgBurn](http://www.imgburn.com/) pour écrire l’image sur le disque
 
-* Sur macOS, utilisez [Disk Utility](http://support.apple.com/kb/ph7025)
+- Sur macOS, utilisez [Disk Utility](http://support.apple.com/kb/ph7025)
 
-* Sur GNU/Linux, vous avez plusieurs choix, tels que [Brasero](https://wiki.gnome.org/Apps/Brasero) ou [K3b](http://www.k3b.org/)
+- Sur GNU/Linux, vous avez plusieurs choix, tels que [Brasero](https://wiki.gnome.org/Apps/Brasero) ou [K3b](http://www.k3b.org/)
 
 [/ui-tab]
 [ui-tab title="Utiliser Ventoy"]
-Ventoy sera utile si vous n'arrivez pas à démarrer l'image de Yunohost en utilisant les autres méthodes
+Ventoy sera utile si vous n'arrivez pas à démarrer l'image de YunoHost en utilisant les autres méthodes
 
 [Ventoy](https://www.ventoy.net/) est un outil pratique qui permet de mettre plusieurs images Linux sur une même clé USB et démarrer ces images sans devoir re-flasher la clé USB à chaque fois. C'est aussi pratique pour démarer une image qui refuse de démarrer: Ventoy réussi habituellement à tout démarrer!
+
 1. Installer [Ventoy](https://www.ventoy.net/) sur la clé USB. Référez-vous aux [instructions d'installation](https://www.ventoy.net/en/doc_start.html).
     - Cela va créer 2 partition sur la clé USB.
-3. En utilisant votre application de fichiers préférée, copiez l'image Yunohost sur la grande partition "Ventoy (pas celle "VTOYEFI")
+2. En utilisant votre application de fichiers préférée, copiez l'image YunoHost sur la grande partition "Ventoy (pas celle "VTOYEFI")
     - N'utilisez pas *Balena Etcher*, USBImager ou `dd` pour faire ça!
 
-Insérez cette clé USB dans l'ordinateur et démarrez en utisant celle-ci. Ventoy va apparaitre et lister toutes les images qui sont sur la clé USB. Sélectionnez l'image de Yunohost. Sélectionnez ensuite "GRUB2" comme option de démarrage (ou utilisez n'importe laquelle qui fonctionnera sur votre ordinateur 😉)
+Insérez cette clé USB dans l'ordinateur et démarrez en utisant celle-ci. Ventoy va apparaitre et lister toutes les images qui sont sur la clé USB. Sélectionnez l'image de YunoHost. Sélectionnez ensuite "GRUB2" comme option de démarrage (ou utilisez n'importe laquelle qui fonctionnera sur votre ordinateur 😉)
 [/ui-tab]
 {% endif %}
 [/ui-tabs]
@@ -363,34 +361,28 @@ Insérez cette clé USB dans l'ordinateur et démarrez en utisant celle-ci. Vent
 
 Allez dans **Réglages** > **Réseau** :
 
-* Sélectionnez `Accès par pont`
+- Sélectionnez `Accès par pont`
-* Choisissez votre interface selon son nom :
+- Choisissez votre interface selon son nom :
     **wlan0** si vous êtes connecté sans-fil, **eth0** ou **eno1** sinon.
 
 ![](image://virtualbox_2.png?class=inline)
 
 {% endif %}
 
-
-
-
-
-
-
-
-
 {% if arm %}
+
 ## [fa=plug /] Démarrer la carte
 
-* Branchez le câble Ethernet (un côté sur votre box, l'autre côté à votre carte).
+- Branchez le câble Ethernet (un côté sur votre box, l'autre côté à votre carte).
-    * Pour les utilisateurs et utilisatrices souhaitant configurer la carte pour la connecter via le WiFi à la place, voir [cet exemple](https://www.raspberrypi.com/documentation/computers/configuration.html#connect-to-a-wireless-network) ([ou là avant YunoHost12/bookworm](https://www.raspberryme.com/configurer-le-wifi-sur-un-pi-manuellement-a-laide-de-wpa_supplicant-conf/).
+  - Pour les utilisateurs et utilisatrices souhaitant configurer la carte pour la connecter via le WiFi à la place, voir [cet exemple](https://www.raspberrypi.com/documentation/computers/configuration.html#connect-to-a-wireless-network) ([ou là avant YunoHost12/bookworm](https://www.raspberryme.com/configurer-le-wifi-sur-un-pi-manuellement-a-laide-de-wpa_supplicant-conf/).
-* Mettez la carte SD dans le serveur.
+- Mettez la carte SD dans le serveur.
-* (Facultatif) Il est possible de brancher un écran et un clavier sur votre serveur en cas de soucis, pour vérifier que le processus de démarrage (boot) se passe bien, ou encore pour avoir un accès direct en console.
+- (Facultatif) Il est possible de brancher un écran et un clavier sur votre serveur en cas de soucis, pour vérifier que le processus de démarrage (boot) se passe bien, ou encore pour avoir un accès direct en console.
-* Branchez l'alimentation.
+- Branchez l'alimentation.
-* Laissez quelques minutes à votre serveur pour s'autoconfigurer durant le premier démarrage.
+- Laissez quelques minutes à votre serveur pour s'autoconfigurer durant le premier démarrage.
-* Assurez-vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box Internet) que votre serveur.
+- Assurez-vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box Internet) que votre serveur.
 
 {% elseif virtualbox %}
+
 ## [fa=plug /] Lancer la machine virtuelle
 
 Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
@@ -400,19 +392,20 @@ Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
 ! Si vous rencontrez l'erreur "VT-x is not available", il vous faut probablement activer (enable) la virtualisation dans les options du BIOS de votre ordinateur.
 
 {% else %}
+
 ## [fa=plug /] Démarrer la machine sur la clé USB
 
-* Branchez le câble Ethernet (un côté à votre box, de l'autre côté à votre carte).
+- Branchez le câble Ethernet (un côté à votre box, de l'autre côté à votre carte).
-* Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez-le comme **périphérique de démarrage (bootable device)** en pressant l’une des touches suivantes (dépendant de votre ordinateur) :
+- Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez-le comme **périphérique de démarrage (bootable device)** en pressant l’une des touches suivantes (dépendant de votre ordinateur) :
 `<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` ou <Alt>.
-    * N.B. : si le serveur était précédemment installé avec une version récente de Windows (8+), vous devez d'abord demander à Windows de « redémarrer réellement ». Vous pouvez le faire dans une option du menu « Options de démarrage avancées ».
+  - N.B. : si le serveur était précédemment installé avec une version récente de Windows (8+), vous devez d'abord demander à Windows de « redémarrer réellement ». Vous pouvez le faire dans une option du menu « Options de démarrage avancées ».
 
-!!! Si vous n'arrivez pas à démarrer l'image Yunohost, essayez d'utiliser Ventoy (sélectionnez "Ventoy" dans la section "Flasher l'image YunoHost" ci-dessus).
+!!! Si vous n'arrivez pas à démarrer l'image YunoHost, essayez d'utiliser Ventoy (sélectionnez "Ventoy" dans la section "Flasher l'image YunoHost" ci-dessus).
 {% endif %}
 
 {% if regular or virtualbox %}
-## [fa=rocket /] Lancer l’installation graphique
 
+## [fa=rocket /] Lancer l’installation graphique
 
 Votre écran devrait ressembler à la capture ci-dessous :
 
@@ -434,7 +427,8 @@ Le projet YunoHost a simplifié au maximum l'installation classique afin d'évit
 
 Avec l'installation en mode expert, vous avez plus de possibilités notamment concernant le partitionnement exact de vos supports de stockages. Vous pouvez aussi décider d'utiliser le mode classique et [ajouter vos disques après coup](/external_storage).
 
-### Résumé des étapes en mode expert:
+### Résumé des étapes en mode expert
+
   1. Sélectionnez `Expert graphical install`
   2. Sélectionnez votre langue, votre localisation, votre agencement de clavier et éventuellement votre timezone.
   3. Partitionner vos disques. C'est à cette étape que vous pouvez configurer un RAID ou chiffrer tout ou partie du serveur.
@@ -460,35 +454,42 @@ Si vous avez un ou des disques durs pour stocker les données, vous pouvez chois
 Si vous souhaitez de la souplesse et ne pas avoir à (re-)dimensionner des partitions, vous pouvez aussi choisir de monter sur `/mnt/hdd` et de suivre ce [tutoriel pour monter l'ensemble de ces dossiers avec `mount --bind`](/external_storage).
 
 ### A propos du chiffrement
+
 Prenez bien en compte que si vous chiffrez tout ou partie de vos disques, vous aurez à taper la phrase de passe à chaque redémarrage de votre serveur, ce qui peut poser problème si vous n'êtes pas sur place. Il existe toutefois des solutions (assez difficiles à mettre en oeuvre) qui permettent de tapper la phrase via SSH ou via une page web (cherchez "dropbear encrypted disk").
 
 ### A propos du RAID
+
 Ne perdez pas de vue que:
- * les disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD)
+
- * un RAID 1 (même sans disque de spare) est plus fiable qu'un RAID5 d'un point de vue probabilité
+- les disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD)
- * les raid matériels sont dépendant de la carte raid, si celle-ci fait défaut il en faudra une de remplacement pour pouvoir lire et reconstruire la grappe
+- un RAID 1 (même sans disque de spare) est plus fiable qu'un RAID5 d'un point de vue probabilité
+- les raid matériels sont dépendant de la carte raid, si celle-ci fait défaut il en faudra une de remplacement pour pouvoir lire et reconstruire la grappe
 
 [/ui-tab]
 [/ui-tabs]
 
-!!! Si l'installation de Yunohost échoue sur votre machine et que vous n'arrivez pas à résoudre le problème, sachez qu'il est aussi possible d'installer Debian et ensuite d'installer Yunohost dessus. Pour les instructions, au sommet de cette page, sélectionnez "Serveur distant" puis "VPS ou serveur dédié avec Debian".
+!!! Si l'installation de YunoHost échoue sur votre machine et que vous n'arrivez pas à résoudre le problème, sachez qu'il est aussi possible d'installer Debian et ensuite d'installer YunoHost dessus. Pour les instructions, au sommet de cette page, sélectionnez "Serveur distant" puis "VPS ou serveur dédié avec Debian".
 {% endif %}
 
-
 {% if rpi012 %}
+
 ## [fa=bug /] Se connecter à la carte et corriger l'image
+
 Les Raspberry Pi 1 et Zero ne sont pas totalement supportés à cause de [problèmes de compilation pour cette architecture](https://github.com/YunoHost/issues/issues/1423).
 
 Cependant, il est possible de corriger l'image par vous-même avant de lancer la configuration initiale.
 
 Pour y parvenir, vous devez vous connecter à votre Raspberry Pi en tant que root [via SSH](/ssh) avec le mot de passe temporaire `yunohost`:
-```
+
+```bash
 ssh root@yunohost.local
 ```
+
 (utilisez `yunohost-2.local`, etc. s'il y a plusieurs serveurs YunoHost sur le réseau)
 
 Ensuite, lancez les commandes suivantes pour contourner le dysfonctionnement de Metronome :
-```
+
+```bash
 mv /usr/bin/metronome{,.bkp}
 mv /usr/bin/metronomectl{,.bkp}
 ln -s /usr/bin/true /usr/bin/metronome
@@ -496,18 +497,20 @@ ln -s /usr/bin/true /usr/bin/metronomectl
 ```
 
 Et celle-ci pour contourner celui de upnpc :
-```
+
+```bash
 sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
 ```
 
 ! Cette dernière commande nécessite d'être lancée après chaque mise à jour de YunoHost :/
 
 {% elseif arm_unsup %}
+
 ## [fa=terminal /] Se connecter à la carte
 
 Ensuite, il vous faut [trouver l'adresse IP locale de votre serveur](/finding_the_local_ip) pour vous connecter en tant que root [via SSH](/ssh) avec le mot de passe temporaire `1234`.
 
-```
+```bash
 ssh root@192.168.x.xxx
 ```
 
@@ -515,8 +518,8 @@ ssh root@192.168.x.xxx
 
 {% endif %}
 
-
 {% if vps_debian or arm_unsup %}
+
 ## [fa=rocket /] Lancer le script d'installation
 
 - Ouvrez la ligne de commande sur votre serveur (soit directement, soit avec [SSH](/ssh))
@@ -526,6 +529,7 @@ ssh root@192.168.x.xxx
 ```bash
 curl https://install.yunohost.org | bash
 ```
+
 !!! Si `curl` n'est pas installé sur votre système, il vous faudra peut-être l'installer avec `apt install curl`.
 !!! Autrement, si la commande n'affiche rien du tout, vous pouvez tenter `apt install ca-certificates`
 
@@ -533,7 +537,6 @@ curl https://install.yunohost.org | bash
 
 {% endif %}
 
-
 ## [fa=cog /] Lancer la configuration initiale
 
 !!! Si vous êtes en train de restaurer une sauvegarde YunoHost, vous devez sauter cette étape et vous référer à la section [Restaurer durant la post-installation à la place de cette étape de configuration initiale](/backup#restoring-during-the-postinstall).
@@ -572,17 +575,17 @@ Vous pouvez aussi lancer la post-installation avec la commande `yunohost tools p
 
 {% if not internetcube %}
 
-##### [fa=globe /] Domaine principal
+### [fa=globe /] Domaine principal
 
 C’est le nom de domaine qui permettra l’accès à votre serveur ainsi qu’au **portail d’authentification** des utilisateurs. Vous pourrez ensuite ajouter d'autres domaines, et changer celui qui sera le domaine principal si besoin.
 
-* Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en **.nohost.me** / **.noho.st** / **.ynh.fr** (exemple : `homersimpson.nohost.me`). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contrôle complet sur votre configuration DNS.
+- Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en **.nohost.me** / **.noho.st** / **.ynh.fr** (exemple : `homersimpson.nohost.me`). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contrôle complet sur votre configuration DNS.
 
-* Si en revanche vous avez déjà votre propre nom de domaine, vous souhaitez probablement l'utiliser. Vous aurez donc besoin ensuite de configurer les enregistrements DNS comme expliqué [ici](/dns_config).
+- Si en revanche vous avez déjà votre propre nom de domaine, vous souhaitez probablement l'utiliser. Vous aurez donc besoin ensuite de configurer les enregistrements DNS comme expliqué [ici](/dns_config).
 
 !!! Oui, vous *devez* configurer un nom de domaine. Si vous n'avez pas de nom de domaine et que vous n'en voulez pas en **.nohost.me**, **.noho.st** ou **.ynh.fr**, vous pouvez utilisez un « faux » domaine comme par exemple `yolo.test` et [modifier votre fichier `/etc/hosts` **sur votre ordinateur local** pour que ce domaine pointe vers l'IP de votre serveur, comme expliqué ici](/dns_local_network).
 
-##### [fa=key /] Premier compte utilisateur
+### [fa=key /] Premier compte utilisateur
 
 [Depuis YunoHost 11.1](https://forum.yunohost.org/t/yunohost-11-1-release-sortie-de-yunohost-11-1/23378), le premier compte utilisateur est créé à cette étape. Il vous faudra choisir un nom d'utilisateur et un mot de passe raisonablement complexe. (Nous ne pouvons que souligner l'importance du choix d'un mot de passe **robuste** !) Ce compte utilisateur sera ajouté au groupe Admins, et pourra se connecter au portail utilisateur, à la webadmin, et se connecter [via **SSH**](/ssh) ou [**SFTP**](/filezilla). Les admins recevront aussi les mails envoyés à `root@votredomaine.tld` et `admin@votredomaine.tld` : ces emails peuvent être utilisés pour envoyer des informations ou des alertes techniques. Vous pourrez plus tard ajouter d'autres comptes utilisateur supplémentaire, qu'il est aussi possible d'ajouter au groupe Admins.
 
@@ -612,10 +615,12 @@ Pour lancer le diagnostic, allez dans l'Administration Web dans la partie Diagno
 
 [/ui-tab]
 [ui-tab title="À partir de la ligne de commande"]
-```
+
+```bash
 yunohost diagnosis run
 yunohost diagnosis show --issues --human-readable
 ```
+
 [/ui-tab]
 [/ui-tabs]
 
@@ -634,9 +639,11 @@ Pour plus d'instructions détaillées, ou pour en savoir plus à propos des cert
 
 [/ui-tab]
 [ui-tab title="À partir de la ligne de commande"]
-```
+
+```bash
 yunohost domain cert install
 ```
+
 [/ui-tab]
 [/ui-tabs]
 

pages/02.administer/10.install/install.md

@@ -132,57 +132,56 @@ Select the hardware on which you want install YunoHost :
 
 [/div]
 
-
 {% if hardware != '' %}
 
 {% if wsl %}
 !! This setup is mainly meant for local testing by advanced users. Due to limitations on WSL's side (changing IP address, notably), selfhosting from it can be tricky and will not be described here.
 {% endif %}
 
-
 ## [fa=list-alt /] Pre-requisites
 
 {% if regular %}
-* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least)
+
+- A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least)
 {% elseif rpi34 %}
-* A Raspberry Pi 3 or 4
+- A Raspberry Pi 3 or 4
 {% elseif rpi012 %}
-* A Raspberry Pi 0, 1 or 2 with at least 512MB RAM 
+- A Raspberry Pi 0, 1 or 2 with at least 512MB RAM
 {% elseif internetcube %}
-* An Orange Pi PC+ or an Olinuxino Lime 1 or 2
+- An Orange Pi PC+ or an Olinuxino Lime 1 or 2
-* A VPN with a dedicated public IP and a `.cube` file
+- A VPN with a dedicated public IP and a `.cube` file
 {% elseif arm_sup %}
-* An Orange Pi PC+ or an Olinuxino Lime 1 or 2
+- An Orange Pi PC+ or an Olinuxino Lime 1 or 2
 {% elseif arm_unsup %}
-* An ARM board with at least 512MB RAM
+- An ARM board with at least 512MB RAM
 {% elseif vps_debian %}
-* A dedicated or virtual private server with Debian 11 (Bullseye) <small>(with **kernel >= 3.12**)</small> preinstalled, 512MB RAM and 16GB capacity (at least)
+- A dedicated or virtual private server with Debian 11 (Bullseye) <small>(with **kernel >= 3.12**)</small> preinstalled, 512MB RAM and 16GB capacity (at least)
 {% elseif vps_ynh %}
-* A dedicated or virtual private server with yunohost preinstalled, 512MB RAM and 16GB capacity (at least)
+- A dedicated or virtual private server with YunoHost preinstalled, 512MB RAM and 16GB capacity (at least)
 {% elseif virtualbox %}
-* An x86 computer with [VirtualBox installed](https://www.virtualbox.org/wiki/Downloads) and enough RAM capacity to be able to run a small virtual machine with 1024MB RAM and 8GB capacity (at least)
+- An x86 computer with [VirtualBox installed](https://www.virtualbox.org/wiki/Downloads) and enough RAM capacity to be able to run a small virtual machine with 1024MB RAM and 8GB capacity (at least)
 {% endif %}
 {% if arm %}
-* A power supply (either an adapter or a MicroUSB cable) for your board;
+- A power supply (either an adapter or a MicroUSB cable) for your board;
-* A microSD card: 16GB capacity (at least), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) highly recommended (such as [this SanDisk A1 card](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/));
+- A microSD card: 16GB capacity (at least), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) highly recommended (such as [this SanDisk A1 card](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/));
 {% endif %}
 {% if regular %}
-* A USB stick with at least 1GB capacity OR a standard blank CD
+- A USB stick with at least 1GB capacity OR a standard blank CD
 {% endif %}
 {% if wsl %}
-* Windows 10 and above
+- Windows 10 and above
-* Administration rights
+- Administration rights
-* Windows Subsystem for Linux, installed from the Optional Features menu of Windows
+- Windows Subsystem for Linux, installed from the Optional Features menu of Windows
-* *Recommended:* Windows Terminal (Preview) app, installed from the Microsoft Store. Much better than the standard Terminal, as it offers shortcuts to the WSL distros.
+- *Recommended:* Windows Terminal (Preview) app, installed from the Microsoft Store. Much better than the standard Terminal, as it offers shortcuts to the WSL distros.
 {% endif %}
 {% if at_home %}
-* A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
+- A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
 {% if not virtualbox %}
-* An ethernet cable (RJ-45) to connect your server to your router. {% if rpi012 %} (Or, for Rasperry Pi Zero : and USB OTG or a wifi Dongle) {% endif %}
+- An ethernet cable (RJ-45) to connect your server to your router. {% if rpi012 %} (Or, for Rasperry Pi Zero : and USB OTG or a wifi Dongle) {% endif %}
 {% endif %}
-* A computer to read this guide, flash the image and access your server.
+- A computer to read this guide, flash the image and access your server.
 {% else %}
-* A computer or a smartphone to read this guide and access your server.
+- A computer or a smartphone to read this guide and access your server.
 {% endif %}
 
 {% if virtualbox %}
@@ -190,7 +189,9 @@ Select the hardware on which you want install YunoHost :
 {% endif %}
 
 {% if wsl %}
+
 ## Introduction
+
 WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless.
 Docker for Windows can now rely on WSL instead of Hyper-V, for example.
 
@@ -225,11 +226,12 @@ sudo apt update
 sudo apt upgrade
 sudo apt dist-upgrade
 ```
+
 ## Prevent WSL from tweaking configuration files
 
 Edit `/etc/wsl.conf` and put the following code in it:
 
-```
+```text
 [network]
 generateHosts = false
 generateResolvConf = false
@@ -252,6 +254,7 @@ Debian on WSL does not have `systemd`, a service configuration software.
 This is a key element for YunoHost, and for any decent Debian distro (seriously MS, what the heck). Let's install it:
 
 1. Install dotNET runtime:
+
 ```bash
 # In WSL
 wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@@ -263,6 +266,7 @@ sudo apt install -y dotnet-sdk-3.1
 ```
 
 2. Install [Genie](https://github.com/arkane-systems/genie):
+
 ```bash
 # In WSL
 # Add their repository
@@ -292,25 +296,28 @@ Always call `genie -s` while starting your distro.
 `wsl -d YunoHost -e genie -s`
 
 ## Backup and restore the distro
+
 ### Make your first distro backup
+
 As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell:
 
-```
+```bash
 cd ~
 wsl --export YunoHost .\WSL\YunoHost.tar.gz
 ```
 
 ### In case of crash, delete and restore the whole distro
 
-```
+```bash
 cd ~
 wsl --unregister YunoHost
 wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
 ```
+
 {% endif %}
 
-
 {% if vps_ynh %}
+
 ## YunoHost VPS providers
 
 Here are some VPS providers supporting YunoHost natively :
@@ -329,8 +336,8 @@ Here are some VPS providers supporting YunoHost natively :
 [/div]
 {% endif %}
 
-
 {% if at_home %}
+
 ## [fa=download /] Download the {{image_type}} image
 
 {% if rpi012 %}
@@ -413,17 +420,16 @@ $(document).ready(function () {
 });
 </script>
 
-
-
-
-
-
 {% if not virtualbox %}
 
 {% if arm %}
+
 ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image
+
 {% else %}
+
 ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image
+
 {% endif %}
 
 Now that you downloaded the image of {{image_type}}, you should flash it on {% if arm %}a microSD card{% else %}a USB stick or a CD/DVD.{% endif %}
@@ -457,27 +463,29 @@ Then run :
 # Replace /dev/mmcblk0 if the name of your device is different...
 dd if=/path/to/yunohost.img of=/dev/mmcblk0
 ```
+
 [/ui-tab]
 {% if regular %}
 [ui-tab title="Burning a CD/DVD"]
 For older devices, you might want to burn a CD/DVD. The software to use depends on your operating system.
 
-* On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc
+- On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc
 
-* On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025)
+- On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025)
 
-* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)
+- On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)
 [/ui-tab]
 [ui-tab title="Using Ventoy"]
-Ventoy will be useful if you can't sucessfully boot the Yunohost image using the other methods.
+Ventoy will be useful if you can't sucessfully boot the YunoHost image using the other methods.
 
 [Ventoy](https://www.ventoy.net/) is a nice tool that makes it really easy to put multiple linux images on a USB stick. When the computer refuses to boot from an image on a usb stick, Ventoy will usually be able to boot it anyway!
+
 1. Install [Ventoy](https://www.ventoy.net/) on the USB stick. Refer to the [install instructions](https://www.ventoy.net/en/doc_start.html).
     - This will create 2 partitions on the stick.
-3. Using your favorite file explorer app, copy the Yunohost image file on the big `Ventoy` partition (not "VTOYEFI")
+2. Using your favorite file explorer app, copy the YunoHost image file on the big `Ventoy` partition (not "VTOYEFI")
     - Don't use *Balena Etcher*, USBImager or `dd` for this!
 
-Later, when you'll boot the computer using this usb stick, Ventoy will appear and will list the images on the USB stick. Select the Yunohost image, then select GRUB2 launch option (or use whichever works for your computer 😉)
+Later, when you'll boot the computer using this usb stick, Ventoy will appear and will list the images on the USB stick. Select the YunoHost image, then select GRUB2 launch option (or use whichever works for your computer 😉)
 [/ui-tab]
 {% endif %}
 [/ui-tabs]
@@ -496,34 +504,28 @@ Later, when you'll boot the computer using this usb stick, Ventoy will appear an
 
 Go to **Settings** > **Network**:
 
-* Select `Bridged adapter`
+- Select `Bridged adapter`
-* Select your interface's name:
+- Select your interface's name:
     **wlan0** if you are connected wirelessly, or **eth0** otherwise.
 
 ![](image://virtualbox_2.png?class=inline)
 
 {% endif %}
 
-
-
-
-
-
-
-
-
 {% if arm %}
+
 ## [fa=plug /] Power up the board
 
-* Plug the ethernet cable (one side on your main router, the other on your board).
+- Plug the ethernet cable (one side on your main router, the other on your board).
-    * For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.com/documentation/computers/configuration.html#connect-to-a-wireless-network) ([or here prior to YunoHost12/bookworm](https://www.raspberryme.com/configurer-le-wifi-sur-un-pi-manuellement-a-laide-de-wpa_supplicant-conf/).
+  - For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.com/documentation/computers/configuration.html#connect-to-a-wireless-network) ([or here prior to YunoHost12/bookworm](https://www.raspberryme.com/configurer-le-wifi-sur-un-pi-manuellement-a-laide-de-wpa_supplicant-conf/).
-* Plug the SD card in your board
+- Plug the SD card in your board
-* (Optional) You can connect a screen+keyboard directly on your board if you want to troubleshoot the boot process or if you're more comfortable to "see what happens" or want a direct access to the board.
+- (Optional) You can connect a screen+keyboard directly on your board if you want to troubleshoot the boot process or if you're more comfortable to "see what happens" or want a direct access to the board.
-* Power up the board
+- Power up the board
-* Wait a couple minutes while the board autoconfigure itself during the first boot
+- Wait a couple minutes while the board autoconfigure itself during the first boot
-* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
+- Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
 
 {% elseif virtualbox %}
+
 ## [fa=plug /] Boot up the virtual machine
 
 Start the virtual machine after selecting the YunoHost image.
@@ -532,19 +534,20 @@ Start the virtual machine after selecting the YunoHost image.
 
 ! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer.
 
-
 {% else %}
+
 ## [fa=plug /] Boot the machine on your USB stick
 
-* Plug the ethernet cable (one side on your main router, the other on your server).
+- Plug the ethernet cable (one side on your main router, the other on your server).
-* Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device**. Depending on your hardware, you will need to press one of the following keys:
+- Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device**. Depending on your hardware, you will need to press one of the following keys:
 `<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` or `<Alt>`.
-    * N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options".
+  - N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options".
 
-!!! If you can't boot the Yunohost image, try using Ventoy (select "Ventoy" in the section "Flash the YunoHost image" above).
+!!! If you can't boot the YunoHost image, try using Ventoy (select "Ventoy" in the section "Flash the YunoHost image" above).
 {% endif %}
 
 {% if regular or virtualbox %}
+
 ## [fa=rocket /] Launch the graphical install
 
 You should see a screen like this:
@@ -569,7 +572,8 @@ The YunoHost project simplified the classic installation as much as possible in
 
 With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage).
 
-### Summary of the steps in expert mode:
+### Summary of the steps in expert mode
+
   1. Select `Expert graphical install`.
   2. Select your language, location, keyboard layout and possibly your timezone.
   3. Partition your disks. This is where you can set up a RAID or encrypt all or part of the server.
@@ -590,40 +594,47 @@ If you have one or more hard drives to store data, you can choose to mount it on
 | `/home/yunohost.backup/archives` | YunoHost backups to be placed ideally elsewhere than on the disks that manage the data |
 | `/home/yunohost.app` | Heavy data from YunoHost applications (nextcloud, matrix...) |
 | `/home/yunohost.multimedia` | Heavy data shared between several applications |
-| `/var/mail` | User mail
+| `/var/mail` | User mail |
 
 If you want flexibility and don't want to (re)size partitions, you can also choose to mount on `/mnt/hdd` and follow this [tutorial to mount all these folders with `mount --bind`](/external_storage).
 
 ### About encryption
+
 Be aware that if you encrypt all or part of your disks, you will have to type the passphrase every time you restart your server, which can be a problem if you are not on site. There are however solutions (quite difficult to implement) that allow you to type the passphrase via SSH or via a web page (search for "dropbear encrypted disk").
 
 ### About RAID
+
 Keep in mind that:
- * the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
+
- * a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
+- the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
- * hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
+- a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
+- hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
 
 [/ui-tab]
 [/ui-tabs]
 
-!!! If the Yunohost installer fails and you can't solve the issue, know that it's also possible to install Debian and then install Yunohost on top. For instructions, at the top of this page, select "Remote server", then "VPS or dedicated server with Debian".
+!!! If the YunoHost installer fails and you can't solve the issue, know that it's also possible to install Debian and then install YunoHost on top. For instructions, at the top of this page, select "Remote server", then "VPS or dedicated server with Debian".
 {% endif %}
 
-
 {% if rpi012 %}
+
 ## [fa=bug /] Connect to the board and hotfix the image
+
 Raspberry Pi 1 and 0 are not totally supported due to [compilation issues for this architecture](https://github.com/YunoHost/issues/issues/1423).
 
 However, it is possible to fix by yourself the image before to run the initial configuration.
 
 To achieve this, you need to connect on your raspberry pi as root user [via SSH](/ssh) with the temporary password `yunohost`:
-```
+
+```bash
 ssh root@yunohost.local
 ```
+
 (or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network)
 
 Then run the following commands to work around the metronome issue:
-```
+
+```bash
 mv /usr/bin/metronome{,.bkp}   
 mv /usr/bin/metronomectl{,.bkp} 
 ln -s /usr/bin/true /usr/bin/metronome
@@ -631,18 +642,20 @@ ln -s /usr/bin/true /usr/bin/metronomectl
 ```
 
 And this one to work around the upnpc issue:
-```
+
+```bash
 sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
 ```
 
-! This last command need to be run after each yunohost upgrade :/
+! This last command need to be run after each YunoHost upgrade :/
 
 {% elseif arm_unsup %}
+
 ## [fa=terminal /] Connect to the board
 
 Next you need to [find the local IP address of your server](/finding_the_local_ip) to connect as root user [via SSH](/ssh) with the temporary password `1234`.
 
-```
+```bash
 ssh root@192.168.x.xxx
 ```
 
@@ -650,8 +663,8 @@ ssh root@192.168.x.xxx
 
 {% endif %}
 
-
 {% if vps_debian or arm_unsup %}
+
 ## [fa=rocket /] Run the install script
 
 - Open a command line prompt on your server (either directly or [through SSH](/ssh))
@@ -707,15 +720,15 @@ You can also perform the postinstallation with the command `yunohost tools posti
 
 {% if not internetcube %}
 
-##### [fa=globe /] Main domain
+### [fa=globe /] Main domain
 
 This will be the domain used by your server's users to access the **authentication portal**. You can later add other domains, and change which one is the main domain if needed.
 
 {% if not wsl %}
 
-* If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration.
+- If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration.
 
-* If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config).
+- If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config).
 
 !!! Yes, you *have to* configure a domain name. If you don't have any domain name and don't want a **.nohost.me** / **.noho.st** / **.ynh.fr** either, you can set up a dummy domain such as `yolo.test` and tweak your **local** `/etc/hosts` file such that this dummy domain [points to the appropriate IP, as explained here](/dns_local_network).
 
@@ -726,25 +739,24 @@ For example, `ynh.wsl`. The tricky part is advertising this domain to your host.
 
 Alter your `C:\Windows\System32\drivers\etc\hosts` file. You should have a line starting by `::1`, update it or add it if needed to get:
 
-```
+```text
 ::1    ynh.wsl localhost
 ```
 
 If you want to create subdomains, do not forget to add them in the `hosts` file too:
 
-```
+```text
 ::1    ynh.wsl subdomain.ynh.wsl localhost
 ```
 
 {% endif %}
 
-##### [fa=key /] First user
+### [fa=key /] First user
 
 [Since YunoHost 11.1](https://forum.yunohost.org/t/yunohost-11-1-release-sortie-de-yunohost-11-1/23378), the first user is now created at this stage. You should pick a username and a reasonably complex password. (We cannot stress enough that the password should be **robust**!) This user will be added to the Admins group, and will therefore be able to access the user portal, the web admin interface, and connect [via **SSH**](/ssh) or [**SFTP**](/filezilla). Admins will also receive emails sent to `root@yourdomain.tld` and `admin@yourdomain.tld` : these emails may be used to send technical informations or alerts. You can later add additional users, which you can also add to the Admins group.
 
 This user replaces the old `admin` user, which some old documentation page may still refer to. In which case : just replace `admin` with your username.
 
-
 ## [fa=stethoscope /] Run the initial diagnosis
 
 Once the postinstall is done, you should be able to actually log in the web admin interface using the credentials of the first user you just created.
@@ -772,10 +784,12 @@ To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial
 
 [/ui-tab]
 [ui-tab title="From the command line"]
-```
+
+```bash
 yunohost diagnosis run
 yunohost diagnosis show --issues --human-readable
 ```
+
 [/ui-tab]
 [/ui-tabs]
 
@@ -796,9 +810,11 @@ Go in Domains > Click on your domain > SSL Certificate
 
 [/ui-tab]
 [ui-tab title="From the command line"]
-```
+
+```bash
 yunohost domain cert install
 ```
+
 [/ui-tab]
 [/ui-tabs]
 

pages/02.administer/10.install/install.ru.md

@@ -132,57 +132,56 @@ routes:
 
 [/div]
 
-
 {% if hardware != '' %}
 
 {% if wsl %}
 !! Эта настройка в основном предназначена для локального тестирования продвинутыми пользователями. Из-за ограничений на стороне WSL (в частности, изменение IP-адреса) самостоятельный хостинг с него может быть сложным и здесь описываться не будет.
 {% endif %}
 
-
 ## [fa=list-alt /] Предварительные условия
 
 {% if regular %}
-* x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее)
+
+- x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее)
 {% elseif rpi34 %}
-* Raspberry Pi 3 or 4
+- Raspberry Pi 3 or 4
 {% elseif rpi012 %}
-* Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ 
+- Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ
 {% elseif internetcube %}
-* Orange Pi PC+ или Olinuxino Lime 1 или 2
+- Orange Pi PC+ или Olinuxino Lime 1 или 2
-* VPN с выделенным общедоступным IP-адресом и файлом `.cube`
+- VPN с выделенным общедоступным IP-адресом и файлом `.cube`
 {% elseif arm_sup %}
-* Orange Pi PC+ или Olinuxino Lime 1 или 2
+- Orange Pi PC+ или Olinuxino Lime 1 или 2
 {% elseif arm_unsup %}
-* Плата ARM с объемом оперативной памяти не менее 512 МБ
+- Плата ARM с объемом оперативной памяти не менее 512 МБ
 {% elseif vps_debian %}
-* Выделенный или виртуальный частный сервер с Debian 11 (Bullseye) <small>(с **kernel >= 3.12**)</small> предустановленный, 512 МБ оперативной памяти и емкость 16 ГБ (не менее)
+- Выделенный или виртуальный частный сервер с Debian 11 (Bullseye) <small>(с **kernel >= 3.12**)</small> предустановленный, 512 МБ оперативной памяти и емкость 16 ГБ (не менее)
 {% elseif vps_ynh %}
-* Выделенный или виртуальный частный сервер с предустановленным YunoHost, 512 МБ оперативной памяти и емкостью не менее 16 ГБ
+- Выделенный или виртуальный частный сервер с предустановленным YunoHost, 512 МБ оперативной памяти и емкостью не менее 16 ГБ
 {% elseif virtualbox %}
-* Компьютер x86 с [установленным VirtualBox](https://www.virtualbox.org/wiki/Downloads) и достаточный объем оперативной памяти, чтобы иметь возможность запускать небольшую виртуальную машину с 1024 МБ оперативной памяти и емкостью 8 ГБ (как минимум).
+- Компьютер x86 с [установленным VirtualBox](https://www.virtualbox.org/wiki/Downloads) и достаточный объем оперативной памяти, чтобы иметь возможность запускать небольшую виртуальную машину с 1024 МБ оперативной памяти и емкостью 8 ГБ (как минимум).
 {% endif %}
 {% if arm %}
 *Источник питания (либо адаптер, либо кабель microUSB) для вашей платы;
-* Карта microSD: емкость 16 ГБ (не менее), [класса "A1"](https://club.dns-shop.ru/blog/t-127-kartyi-pamyati/59683-klassyi-skorosti-kart-pamyati-kak-razobratsya-i-chto-brat/#sub_Klass__skorosti__dlya__rabotyi__s__prilojeniyami) настоятельно рекомендуется (например, [эта SanDisk A1 карта](https://www.dns-shop.ru/product/dd976fc32e66ed20/karta-pamati-sandisk-ultra-microsdxc-64-gb-sdsqua4-064g-gn6mn/));
+- Карта microSD: емкость 16 ГБ (не менее), [класса "A1"](https://club.dns-shop.ru/blog/t-127-kartyi-pamyati/59683-klassyi-skorosti-kart-pamyati-kak-razobratsya-i-chto-brat/#sub_Klass__skorosti__dlya__rabotyi__s__prilojeniyami) настоятельно рекомендуется (например, [эта SanDisk A1 карта](https://www.dns-shop.ru/product/dd976fc32e66ed20/karta-pamati-sandisk-ultra-microsdxc-64-gb-sdsqua4-064g-gn6mn/));
 {% endif %}
 {% if regular %}
-* USB-накопитель емкостью не менее 1 ГБ или стандартный чистый компакт-диск
+- USB-накопитель емкостью не менее 1 ГБ или стандартный чистый компакт-диск
 {% endif %}
 {% if wsl %}
-* Windows 10 и выше
+- Windows 10 и выше
-* Права администратора
+- Права администратора
-* Подсистема Windows для Linux, устанавливаемая из *Включение или отключение компонентов Windows*
+- Подсистема Windows для Linux, устанавливаемая из *Включение или отключение компонентов Windows*
-* *Рекомендуется:* Приложение Windows Terminal (предварительный просмотр), установленное из магазина Microsoft Store. Намного лучше, чем стандартный терминал, поскольку он предлагает быстрые пути к дистрибутивам WSL.
+- *Рекомендуется:* Приложение Windows Terminal (предварительный просмотр), установленное из магазина Microsoft Store. Намного лучше, чем стандартный терминал, поскольку он предлагает быстрые пути к дистрибутивам WSL.
 {% endif %}
 {% if at_home %}
-* [хороший Интернет-провайдер](/isp), предпочтительно с хорошей и неограниченной восходящей полосой пропускания
+- [хороший Интернет-провайдер](/isp), предпочтительно с хорошей и неограниченной восходящей полосой пропускания
 {% if not virtualbox %}
-* Кабель Ethernet (RJ-45) для подключения вашего сервера к маршрутизатору. {% if rpi012 %} (Или, для Rasperry Pi Zero: и USB OTG или wifi-адаптер) {% endif %}
+- Кабель Ethernet (RJ-45) для подключения вашего сервера к маршрутизатору. {% if rpi012 %} (Или, для Rasperry Pi Zero: и USB OTG или wifi-адаптер) {% endif %}
 {% endif %}
-* Компьютер, чтобы прочитать это руководство, прошейте изображение и получите доступ к вашему серверу.
+- Компьютер, чтобы прочитать это руководство, прошейте изображение и получите доступ к вашему серверу.
 {% else %}
-* Компьютер или смартфон, чтобы прочитать это руководство и получить доступ к вашему серверу.
+- Компьютер или смартфон, чтобы прочитать это руководство и получить доступ к вашему серверу.
 {% endif %}
 
 {% if virtualbox %}
@@ -190,7 +189,9 @@ routes:
 {% endif %}
 
 {% if wsl %}
+
 ## Вступление
+
 WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless.
 Docker for Windows can now rely on WSL instead of Hyper-V, for example.
 
@@ -225,6 +226,7 @@ sudo apt update
 sudo apt upgrade
 sudo apt dist-upgrade
 ```
+
 ## Prevent WSL from tweaking configuration files
 
 Edit `/etc/wsl.conf` and put the following code in it:
@@ -252,6 +254,7 @@ Debian on WSL does not have `systemd`, a service configuration software.
 This is a key element for YunoHost, and for any decent Debian distro (seriously MS, what the heck). Let's install it:
 
 1. Install dotNET runtime:
+
 ```bash
 # In WSL
 wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@@ -263,6 +266,7 @@ sudo apt install -y dotnet-sdk-3.1
 ```
 
 2. Install [Genie](https://github.com/arkane-systems/genie):
+
 ```bash
 # In WSL
 # Add their repository
@@ -292,25 +296,28 @@ Always call `genie -s` while starting your distro.
 `wsl -d YunoHost -e genie -s`
 
 ## Backup and restore the distro
+
 ### Make your first distro backup
+
 As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell:
 
-```
+```bash
 cd ~
 wsl --export YunoHost .\WSL\YunoHost.tar.gz
 ```
 
 ### In case of crash, delete and restore the whole distro
 
-```
+```bash
 cd ~
 wsl --unregister YunoHost
 wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
 ```
+
 {% endif %}
 
-
 {% if vps_ynh %}
+
 ## YunoHost VPS providers
 
 Here are some VPS providers supporting YunoHost natively :
@@ -329,8 +336,8 @@ Here are some VPS providers supporting YunoHost natively :
 [/div]
 {% endif %}
 
-
 {% if at_home %}
+
 ## [fa=download /] Download the {{image_type}} image
 
 {% if rpi012 %}
@@ -413,17 +420,16 @@ $(document).ready(function () {
 });
 </script>
 
-
-
-
-
-
 {% if not virtualbox %}
 
 {% if arm %}
+
 ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image
+
 {% else %}
+
 ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image
+
 {% endif %}
 
 Now that you downloaded the image of {{image_type}}, you should flash it on {% if arm %}a microSD card{% else %}a USB stick or a CD/DVD.{% endif %}
@@ -457,16 +463,17 @@ Then run :
 # Replace /dev/mmcblk0 if the name of your device is different...
 dd if=/path/to/yunohost.img of=/dev/mmcblk0
 ```
+
 [/ui-tab]
 {% if regular %}
 [ui-tab title="Burning a CD/DVD"]
 For older devices, you might want to burn a CD/DVD. The software to use depends on your operating system.
 
-* On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc
+- On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc
 
-* On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025)
+- On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025)
 
-* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)
+- On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)
 [/ui-tab]
 {% endif %}
 [/ui-tabs]
@@ -485,34 +492,28 @@ For older devices, you might want to burn a CD/DVD. The software to use depends
 
 Go to **Settings** > **Network**:
 
-* Select `Bridged adapter`
+- Select `Bridged adapter`
-* Select your interface's name:
+- Select your interface's name:
     **wlan0** if you are connected wirelessly, or **eth0** otherwise.
 
 ![](image://virtualbox_2.png?class=inline)
 
 {% endif %}
 
-
-
-
-
-
-
-
-
 {% if arm %}
+
 ## [fa=plug /] Power up the board
 
-* Plug the ethernet cable (one side on your main router, the other on your board).
+- Plug the ethernet cable (one side on your main router, the other on your board).
-    * For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
+  - For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
-* Plug the SD card in your board
+- Plug the SD card in your board
-* (Optional) You can connect a screen+keyboard directly on your board if you want to troubleshoot the boot process or if you're more comfortable to "see what happens" or want a direct access to the board.
+- (Optional) You can connect a screen+keyboard directly on your board if you want to troubleshoot the boot process or if you're more comfortable to "see what happens" or want a direct access to the board.
-* Power up the board
+- Power up the board
-* Wait a couple minutes while the board autoconfigure itself during the first boot
+- Wait a couple minutes while the board autoconfigure itself during the first boot
-* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
+- Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
 
 {% elseif virtualbox %}
+
 ## [fa=plug /] Boot up the virtual machine
 
 Start the virtual machine after selecting the YunoHost image.
@@ -521,17 +522,18 @@ Start the virtual machine after selecting the YunoHost image.
 
 ! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer.
 
-
 {% else %}
+
 ## [fa=plug /] Boot the machine on your USB stick
 
-* Plug the ethernet cable (one side on your main router, the other on your server).
+- Plug the ethernet cable (one side on your main router, the other on your server).
-* Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific):
+- Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific):
 `<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` or `<DEL>`.
-    * N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options".
+  - N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options".
 {% endif %}
 
 {% if regular or virtualbox %}
+
 ## [fa=rocket /] Launch the graphical install
 
 You should see a screen like this:
@@ -556,7 +558,8 @@ The YunoHost project simplified the classic installation as much as possible in
 
 With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage).
 
-### Summary of the steps in expert mode:
+### Summary of the steps in expert mode
+
   1. Select `Expert graphical install`.
   2. Select your language, location, keyboard layout and possibly your timezone.
   3. Partition your disks. This is where you can set up a RAID or encrypt all or part of the server.
@@ -577,38 +580,45 @@ If you have one or more hard drives to store data, you can choose to mount it on
 | `/home/yunohost.backup/archives` | YunoHost backups to be placed ideally elsewhere than on the disks that manage the data |
 | `/home/yunohost.app` | Heavy data from YunoHost applications (nextcloud, matrix...) |
 | `/home/yunohost.multimedia` | Heavy data shared between several applications |
-| `/var/mail` | User mail
+| `/var/mail` | User mail |
 
 If you want flexibility and don't want to (re)size partitions, you can also choose to mount on `/mnt/hdd` and follow this [tutorial to mount all these folders with `mount --bind`](/external_storage).
 
 ### About encryption
+
 Be aware that if you encrypt all or part of your disks, you will have to type the passphrase every time you restart your server, which can be a problem if you are not on site. There are however solutions (quite difficult to implement) that allow you to type the passphrase via SSH or via a web page (search for "dropbear encrypted disk").
 
 ### About RAID
+
 Keep in mind that:
- * the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
+
- * a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
+- the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
- * hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
+- a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
+- hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
 
 [/ui-tab]
 [/ui-tabs]
 {% endif %}
 
-
 {% if rpi012 %}
+
 ## [fa=bug /] Connect to the board and hotfix the image
+
 Raspberry Pi 1 and 0 are not totally supported due to [compilation issues for this architecture](https://github.com/YunoHost/issues/issues/1423).
 
 However, it is possible to fix by yourself the image before to run the initial configuration.
 
 To achieve this, you need to connect on your raspberry pi as root user [via SSH](/ssh) with the temporary password `yunohost`:
-```
+
+```bash
 ssh root@yunohost.local
 ```
+
 (or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network)
 
 Then run the following commands to work around the metronome issue:
-```
+
+```bash
 mv /usr/bin/metronome{,.bkp}   
 mv /usr/bin/metronomectl{,.bkp} 
 ln -s /usr/bin/true /usr/bin/metronome
@@ -616,18 +626,20 @@ ln -s /usr/bin/true /usr/bin/metronomectl
 ```
 
 And this one to work around the upnpc issue:
-```
+
+```bash
 sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
 ```
 
-! This last command need to be run after each yunohost upgrade :/
+! This last command need to be run after each YunoHost upgrade :/
 
 {% elseif arm_unsup %}
+
 ## [fa=terminal /] Connect to the board
 
 Next you need to [find the local IP address of your server](/finding_the_local_ip) to connect as root user [via SSH](/ssh) with the temporary password `1234`.
 
-```
+```bash
 ssh root@192.168.x.xxx
 ```
 
@@ -635,8 +647,8 @@ ssh root@192.168.x.xxx
 
 {% endif %}
 
-
 {% if vps_debian or arm_unsup %}
+
 ## [fa=rocket /] Run the install script
 
 - Open a command line prompt on your server (either directly or [through SSH](/ssh))
@@ -692,15 +704,15 @@ You can also perform the postinstallation with the command `yunohost tools posti
 
 {% if not internetcube %}
 
-##### [fa=globe /] Main domain
+### [fa=globe /] Main domain
 
 This will be the domain used by your server's users to access the **authentication portal**. You can later add other domains, and change which one is the main domain if needed.
 
 {% if not wsl %}
 
-* If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration.
+- If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration.
 
-* If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config).
+- If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config).
 
 !!! Yes, you *have to* configure a domain name. If you don't have any domain name and don't want a **.nohost.me** / **.noho.st** / **.ynh.fr** either, you can set up a dummy domain such as `yolo.test` and tweak your **local** `/etc/hosts` file such that this dummy domain [points to the appropriate IP, as explained here](/dns_local_network).
 
@@ -711,25 +723,24 @@ For example, `ynh.wsl`. The tricky part is advertising this domain to your host.
 
 Alter your `C:\Windows\System32\drivers\etc\hosts` file. You should have a line starting by `::1`, update it or add it if needed to get:
 
-```
+```text
 ::1    ynh.wsl localhost
 ```
 
 If you want to create subdomains, do not forget to add them in the `hosts` file too:
 
-```
+```text
 ::1    ynh.wsl subdomain.ynh.wsl localhost
 ```
 
 {% endif %}
 
-##### [fa=key /] First user
+### [fa=key /] First user
 
 [Since YunoHost 11.1](https://forum.yunohost.org/t/yunohost-11-1-release-sortie-de-yunohost-11-1/23378), the first user is now created at this stage. You should pick a username and a reasonably complex password. (We cannot stress enough that the password should be **robust**!) This user will be added to the Admins group, and will therefore be able to access the user portal, the web admin interface, and connect [via **SSH**](/ssh) or [**SFTP**](/filezilla). Admins will also receive emails sent to `root@yourdomain.tld` and `admin@yourdomain.tld` : these emails may be used to send technical informations or alerts. You can later add additional users, which you can also add to the Admins group.
 
 This user replaces the old `admin` user, which some old documentation page may still refer to. In which case : just replace `admin` with your username.
 
-
 ## [fa=stethoscope /] Run the initial diagnosis
 
 Once the postinstall is done, you should be able to actually log in the web admin interface using the credentials of the first user you just created.
@@ -757,10 +768,12 @@ To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial
 
 [/ui-tab]
 [ui-tab title="From the command line"]
-```
+
+```bash
 yunohost diagnosis run
 yunohost diagnosis show --issues --human-readable
 ```
+
 [/ui-tab]
 [/ui-tabs]
 
@@ -781,9 +794,11 @@ Go in Domains > Click on your domain > SSL Certificate
 
 [/ui-tab]
 [ui-tab title="From the command line"]
-```
+
+```bash
 yunohost domain cert install
 ```
+
 [/ui-tab]
 [/ui-tabs]
 

pages/02.administer/15.admin_guide/05.guidelines/guidelines.de.md

@@ -14,6 +14,7 @@ Diese Seite listet einige Tipps und Richtlinien auf, die jeder YunoHost-Administ
 Das heißt : Entweder ist der Server für den Betreib vorgesehen, oder ein Testserver, auf dem Sie sich erlauben, zu experimentieren.
 
 Ist Ihr Ziel, einen Produktionserver zu benutzen, so beachten Sie folgendes :
+
 - ein Server ist ein empfindliches System : Seien Sie vorsichtig, methodisch und geduldig ;
 - experimentieren und Anpassen einschränken - insbesondere von Konfigurationsdateien ;
 - nicht Dutzende von Anwendungen installieren, bloß zum sehen, wie sie aussehen ;
@@ -23,6 +24,7 @@ Ist Ihr Ziel, einen Produktionserver zu benutzen, so beachten Sie folgendes :
 ## Keep it simple !
 
 YunoHost ist für allgemeine und einfache Anwendungsfälle konzipiert. Wenn Sie von diesen Bedingungen abweichen, wird es schwieriger, und Sie benötigen technisches Wissen, um sie zu erfüllen. Zum Beispiel:
+
 - Versuchen Sie nicht, YunoHost in einem Kontext auszuführen, in dem Sie keine Kontrolle über die Ports 80 und 443 haben (oder überhaupt kein Internet);
 - Versuchen Sie nicht, fünf Server über dieselbe Internetverbindung zu hosten, wenn Sie nicht bereits ein fortgeschrittener Benutzer sind;
 - Reiben Sie sich nicht an dem Versuch auf, NGINX durch Apache zu ersetzen (oder beides gleichzeitig laufen zu lassen);
@@ -45,7 +47,7 @@ Wenn Sie Dienste und Daten hosten, die für Ihre Benutzer wichtig sind, ist es w
 
 Als Administrator sollten Sie einen E-Mail-Client so einrichten, dass er E-Mails prüft, die an `root@your.domain.tld` (das muss ein Alias für den ersten von Ihnen hinzugefügten Benutzer sein) gesendet werden, oder sie an eine andere Adresse weiterleitet, die Sie aktiv prüfen. Diese E-Mails können Informationen darüber enthalten, was auf Ihrem Server passiert, wie z. B. periodische automatisierte Aufgaben.
 
-## YunoHost ist freie Software, die von Freiwilligen instand gehalten wird.
+## YunoHost ist freie Software, die von Freiwilligen instand gehalten wird
 
 Schließlich sollten Sie bedenken, dass YunoHost eine freie Software ist, die von Freiwilligen gepflegt wird - und dass das Ziel von YunoHost (die Demokratisierung des Selbst-Hostings) nicht einfach ist! Die Software wird ohne jegliche Garantie zur Verfügung gestellt. Das YunoHost Team tut sein Bestes, um das bestmögliche Erlebnis zu erhalten und zu bieten - dennoch sind die Funktionen, Anwendungen und YunoHost als Ganzes weit davon entfernt, perfekt zu sein, und Sie werden früher oder später auf kleine oder große Probleme stoßen. Wenn das passiert, kommen Sie bitte [in den Chat oder das Forum und bitten um Hilfe, oder melden das Problem](/help) :)!
 

pages/02.administer/15.admin_guide/05.guidelines/guidelines.fr.md

@@ -14,15 +14,17 @@ Cette page énumère quelques conseils et lignes directrices que tout administra
 En d'autres termes : votre serveur est soit un « serveur de production » (destiné à fonctionner), soit un serveur de test sur lequel vous vous permettez d'expérimenter.
 
 Si votre but est d'avoir un serveur de production :
+
 - soyez conscient qu'un serveur est un système fragile : restez prudent, méthodique et patient ;
 - limitez les expérimentations et la personnalisation - notamment des fichiers de config ;
 - n'installez pas des douzaines d'applications juste pour voir de quoi elles ont l'air ;
 - utilisez les applications non-officielles avec prudence, et interdisez-vous d'utiliser celles marquées 'in progress', 'not working' ou qui sont en niveau 0 ;
 - si quelque chose casse, réfléchissez à deux fois avant de tenter de le réparer vous-même si vous ne savez pas ce que vous faites. <small>(Par exemple, n'essayez pas de recréer vous-même l'utilisateur admin juste parce qu'il a mystérieusement disparu...)</small>
 
-## Keep it simple !
+## Restez simple !
+
+YunoHost est conçu pour fonctionner avec des cas d'utilisation généraux et simples. S'écarter de ces conditions rendra les choses plus difficiles et vous aurez besoin de connaissances techniques pour les faire fonctionner. Par exemple :
 
-YunoHost est conçu pour fonctionner avec des cas d'utilisation généraux et simples. S'écarter de ces conditions rendra les choses plus difficiles et vous aurez besoin de connaissances techniques pour les faire fonctionner. Par exemple,
 - n'essayez pas d'exécuter YunoHost dans un contexte où vous ne pouvez pas avoir le contrôle des ports 80 et 443 (ou pas d'Internet du tout) ;
 - n'essayez pas d'héberger cinq serveurs derrière la même connexion Internet si vous n'êtes pas déjà un utilisateur avancé ;
 - ne vous tourmentez pas à vouloir remplacer NGINX par Apache (ou faire tourner les deux à la fois) ;
@@ -45,7 +47,7 @@ Si vous hébergez des services et des données qui sont importants pour vos util
 
 En tant qu'administrateur, vous devriez configurer un client de messagerie pour vérifier les e-mails envoyés à `root@votre.domaine.tld` (qui doit être un alias pour le premier utilisateur que vous avez ajouté) ou les transférer à une autre adresse que vous vérifiez activement. Ces courriels peuvent contenir des informations sur ce qui se passe sur votre serveur, comme les tâches périodiques automatisées.
 
-## YunoHost est un logiciel gratuit, maintenu par des bénévoles.
+## YunoHost est un logiciel gratuit, maintenu par des bénévoles
 
 Enfin, gardez à l'esprit que YunoHost est un logiciel libre maintenu par des volontaires - et que le but de YunoHost (démocratiser l'auto-hébergement) n'est pas simple ! Le logiciel est fourni sans aucune garantie. L'équipe de bénévoles fait de son mieux pour maintenir et fournir la meilleure expérience possible - pourtant les fonctionnalités, les applications et YunoHost dans son ensemble sont loin d'être parfaits et vous ferez face tôt ou tard à de petit ou gros problèmes. Lorsque cela se produit, venez gentiment [demander de l'aide sur le chat ou le forum, ou signaler le problème](/help) :) !
 

pages/02.administer/15.admin_guide/05.guidelines/guidelines.it.md

@@ -14,6 +14,7 @@ Questa pagina elenca qualche consiglio e delle linee guida che tutti gli amminis
 In altre parole: il tuo server può essere un "server in produzione" (destinato a funzionare), oppure un server di test che ti permette di sperimentare.
 
 Se il tuo obiettivo è avere un server in produzione:
+
 - sii consapevole che i server sono sistemi fragili: sii prudente, metodico e paziente;
 - limita gli esperimenti e le personalizzazioni (per le istanze il file config)
 - non installare dozzine di installazioni solo per vedere come sono;
@@ -22,7 +23,8 @@ Se il tuo obiettivo è avere un server in produzione:
 
 ## Keep it simple !
 
-YunoHost è progettato per funzionare in casi d'uso generici e semplici. Deviare da queste condizioni renderà le cose più difficili e avrai bisogno di conoscenze tecniche perché tutto funzioni. Per esempio,
+YunoHost è progettato per funzionare in casi d'uso generici e semplici. Deviare da queste condizioni renderà le cose più difficili e avrai bisogno di conoscenze tecniche perché tutto funzioni. Per esempio:
+
 - non provare ad eseguire YunoHost in un contesto dove non puoi controllare le porte 80 e 443 (o senza Internet del tutto);
 - non provare a hostare cinque server dietro la stessa connessione Internet se non sei un utente esperto;
 - non cadere nei capricci dei nerd che vogliono sostituire NGINX con Apache (o farli girare tutti e due insieme);
@@ -45,7 +47,7 @@ Se ospiti dei servizi e dei dati che sono importanti per i tuoi utenti, è impor
 
 Come amministratore, dovrai configurare un client di posta per controllare le mail inviate a `root@your.domani.tld` (che dovrà essere un alias per il primo utente che aggiungerai) o trasferitele ad un altro indirizzo mail che controlli attivamente. Queste mail possono contenere informazioni riguardo quello che avviene sul tuo server, come i compiti periodici automatici.
 
-## YunoHost è software libero, mantenuto da volontari.
+## YunoHost è software libero, mantenuto da volontari
 
 Infine, tieni presente che YunoHost è software libero mantenuto da volontari - e che l'obiettivo di YunoHost (democratizzare il self-hosting) non è semplice! Il software è fornito senza nessuna garanzia. Il team di volontari fa del suo meglio per mantenere e fornire la migliore esperienza possibile - quindi le funzionalità, le applicazioni e YunoHost nel suo insieme sono lontani dall'essere perfetti e presto o tardi incontrerai piccoli o grossi problemi. Quando accadrà potrai [chiedere aiuto sulla chat o nel forum, o segnalare il problema](/help) :)!
 

pages/02.administer/15.admin_guide/05.guidelines/guidelines.md

@@ -14,6 +14,7 @@ This page lists some advice and guidelines which every YunoHost administrator sh
 To put it another way: your server is either a production server (meant to work) or a test server on which you allow yourself to experiment.
 
 If your goal is to run a production server:
+
 - be aware that servers are fragile system. Stay cautious, methodical and patient;
 - limit experimentations and customizations (for instance of config file);
 - do not install dozens of apps just to see how they look;
@@ -22,7 +23,8 @@ If your goal is to run a production server:
 
 ## Keep it simple!
 
-YunoHost is designed to work with general and simple use cases in mind. Deviating from those conditions will make things harder and you will need technical knowledge to make it work. For instance, 
+YunoHost is designed to work with general and simple use cases in mind. Deviating from those conditions will make things harder and you will need technical knowledge to make it work. For instance:
+
 - do not try to run YunoHost in a context where you cannot have control over ports 80 and 443 (or no internet at all);
 - do not try to host five servers behind the same internet connection if you are not already an advanced user;
 - do not fall into nerd whims such as willing to replace NGINX with Apache (or run both at the same time);

pages/02.administer/15.admin_guide/10.admin/admin.de.md

@@ -11,6 +11,6 @@ YunoHost hat ein Administrator-Webinterface. Die andere Möglichkeit, Ihre YunoH
 
 ### Zugang
 
-Sie können auf Ihr Administrator-Webinterface unter folgender Adresse zugreifen: https://example.org/yunohost/admin (ersetzen Sie 'example.org' durch Ihren eigenen Domainnamen)
+Sie können auf Ihr Administrator-Webinterface unter folgender Adresse zugreifen: <https://example.org/yunohost/admin> (ersetzen Sie `example.org` durch Ihren eigenen Domainnamen)
 
 ![](image://webadmin.png)

pages/02.administer/15.admin_guide/10.admin/admin.es.md

@@ -11,6 +11,6 @@ YunoHost tiene una interfaz gráfica de administración. El otro método consist
 
 ### Acceso
 
-La interfaz admin está accesible desde tu instancia YunoHost en esta dirección : https://ejemplo.org/yunohost/admin (reemplaza ejemplo.org por tu nombre de dominio)
+La interfaz admin está accesible desde tu instancia YunoHost en esta dirección : <https://ejemplo.org/yunohost/admin> (reemplaza `ejemplo.org` por tu nombre de dominio)
 
 ![](image://webadmin.png)

pages/02.administer/15.admin_guide/10.admin/admin.fr.md

@@ -11,7 +11,6 @@ YunoHost est fourni avec une interface graphique d’administration (aussi appel
 
 ### Accès
 
-L’interface d'administration web est accessible depuis votre instance YunoHost à l’adresse https://exemple.org/yunohost/admin (remplacez exemple.org par la bonne valeur)
+L’interface d'administration web est accessible depuis votre instance YunoHost à l’adresse <https://exemple.org/yunohost/admin> (remplacez `exemple.org` par la bonne valeur)
 
 ![](image://webadmin_fr.png)
-

pages/02.administer/15.admin_guide/10.admin/admin.it.md

@@ -11,7 +11,6 @@ YunoHost ha un'interfaccia web di amministrazione. L'altro metodo è quello di u
 
 ### Accesso
 
-L'interfaccia di amministrazione è accessibile all'indirizzo https://example.org/yunohost/admin (sostituisci 'example.org' con il tuo dominio)
+L'interfaccia di amministrazione è accessibile all'indirizzo <https://example.org/yunohost/admin> (sostituisci `example.org` con il tuo dominio)
 
 ![](image://webadmin.png)
-

pages/02.administer/15.admin_guide/10.admin/admin.md

@@ -11,6 +11,6 @@ YunoHost has an administrator web interface. The other way to administrate your
 
 ### Access
 
-You can access your administrator web interface at this address: https://example.org/yunohost/admin (replace 'example.org' with your own domain name)
+You can access your administrator web interface at this address: <https://example.org/yunohost/admin> (replace `example.org` with your own domain name)
 
 ![](image://webadmin.png)

pages/02.administer/15.admin_guide/15.command_line/command_line.de.md

@@ -17,17 +17,18 @@ page-toc:
 
 ## Während der YunoHost Installation
 
-#### Finde deine IP
+### Finde deine IP
 
 Solltest du auf einem VPS installieren, dann hat der VPS Provider die IP-Adresse, die du bei ihm erfragen solltest.
 
 Wenn du Zuhause installierst (z.B. auf einem Raspberry Pi oder OLinuXino), dann musst du herausfinden, welche IP-Adresse dein Router dem System zugewiesen hat. Hierfür existieren mehrere Wege:
+
 - Öffne ein Terminal und tippe `sudo arp-scan --local` ein, um eine Liste der aktiven IP-Adressen deines lokalen Netzwerks anzuzeigen;
 - wenn dir der arp-scan eine zu unübersichtliche Zahl an Adressen anzeigt, versuche mit `nmap -p 22 192.168.**x**.0/24` nur die anzuzeigen, deren SSH-Port 22 offen ist. (passe das **x** deinem Netzwerk an);
 - Prüfe die angezeigten Geräte in der Benutzeroberfläche deines Routers, ob du das Gerät findest;
 - Schließe einen Bildschirm und Tastatur an deinen Server, logge dich ein und tippe `hostname --all-ip-address`.
 
-#### Verbinden
+### Verbinden
 
 Angenommen deine IP Addresse ist `111.222.333.444`, öffne einen Terminal und gib Folgendes ein:
 
@@ -39,11 +40,11 @@ Es wird nach einem Passwort gefragt. Handelt es sich um einen VPS, sollte der VP
 
 ! Seit YunoHost 3.4 kann man sich nach dem Ausführen der Postinstallation nicht mehr als `root` anmelden. **Stattdessen sollte man sich mit dem `admin` Benutzer anmelden!** Für den Fall, dass der LDAP-Server defekt und der `admin` Benutzer nicht verwendbar ist, kann man sich eventuell trotzdem noch mit `root` über das lokale Netzwerk anmelden.
 
-#### Ändere das Passwort!
+### Ändere das Passwort!
 
 Nach dem allerersten Login sollte man das root Passwort ändern. Der Server könnte dazu automatisch auffordern. Falls nicht, ist der Befehl `passwd` zu benutzen. Es ist wichtig, ein einigermaßen starkes Passwort zu wählen. Beachte, dass das root Passwort durch das admin Passwort überschrieben wird, wenn man die Postinstallation durchführt.
 
-#### Auf ans Konfigurieren!
+### Auf ans Konfigurieren!
 
 Wir sind nun bereit, mit der [Postinstallation](/postinstall) zu beginnen.
 
@@ -103,16 +104,15 @@ N.B.: `fail2ban` sperrt deine IP für 10 Minuten, wenn du 5 fehlgeschlagene Logi
 
 Eine ausführlichere Diskussion über Sicherheit & SSH findest du auf der [dedicated page](/security).
 
-
 ## YunoHost Kommandozeile
 
 !!! Ein vollständiges Tutorial über die Kommandozeile würde den Rahmen der YunoHost-Dokumentation sprengen: Lies dazu am besten ein spezielles Tutorial wie [dieses](https://ryanstutorials.net/linuxtutorial/) oder [dieses](http://linuxcommand.org/). Aber sei versichert, dass du kein CLI-Experte sein musst, um es zu benutzen!
 
-Der Befehl "yunohost" kann zur Verwaltung deines Servers verwendet werden und führt verschiedene Aktionen aus, die denen des Webadmin ähneln. Der Befehl muss entweder vom `root`-Benutzer oder vom `admin`-Benutzer durch Voranstellen von `sudo` gestartet werden. (ProTip™ : Du kannst `root` mit dem Befehl `sudo su` als `admin` werden).
+Der Befehl `yunohost` kann zur Verwaltung deines Servers verwendet werden und führt verschiedene Aktionen aus, die denen des Webadmin ähneln. Der Befehl muss entweder vom `root`-Benutzer oder vom `admin`-Benutzer durch Voranstellen von `sudo` gestartet werden. (ProTip™ : Du kannst `root` mit dem Befehl `sudo su` als `admin` werden).
 
 YunoHost-Befehle haben normalerweise diese Art von Struktur:
 
-```bash
+```text
 yunohost app install wordpress --label Webmail
           ^    ^        ^             ^
           |    |        |             |

pages/02.administer/15.admin_guide/15.command_line/command_line.es.md

@@ -19,7 +19,7 @@ La interfaz de línea de comandos (CLI) es, en informática, la manera original
 
 ## Durante la instalación de YunoHost
 
-#### Encontrar su IP
+### Encontrar su IP
 
 Si instalas YunoHost en un VPS, tu proveedor debería haberte comunicado la dirección IP de tu servidor.
 
@@ -29,7 +29,7 @@ Si instalas un servidor en tu casa (por ejemplo en Raspberry Pi u OLinuXino), ti
 - utiliza la interfaz de tu router caja internet para listar las máquinas conectadas, o mira los los ;
 - conecta una pantalla en tu servidor, inicia una sesión y escribe `hostname --all-ip-address`.
 
-#### Conectarse
+### Conectarse
 
 Suponiendo que tu dirección IP sea `111.222.333.444`, abre una terminal y escribe :
 
@@ -41,11 +41,10 @@ Ahora te piden una contraseña. Si es un VPS, tu proveedor ya te hará comunicad
 
 ! Desde YunoHost 3.4, después de la post-instalación ya no es posible conectarse con el usuario `root`. En lugar de eso, hace falta **conectarse con el usuario `admin`**. Incluso si el servidor LDAP fuera quebrado (haciendo que el usuario `admin` ya no fuera utilizable) todavía deberías poder conectarte con el usuario `root` desde la red local.
 
-#### ¡ Cambiar la contraseña root !
+### ¡ Cambiar la contraseña root !
 
 Después de haberte conectado por primera vez, tienes que cambiar la contraseña `root`. Tal vez el servidor te pida automáticamente que lo hagas. Si no es el caso, hay que utilizar el comando `passwd`. Es muy importante que elijas una contraseña bastante complicada. Nota que esta contraseña luego estará reemplazada por la contraseña admin elegida durante la post-instalación.
 
-
 ## En una instancia que ya está instalada
 
 Si instalaste tu servidor en casa y que quieres conectarte desde fuera de la red local, asegúrate que hayas previamente redirigido el puerto 22 de tu router / caja hacia tu servidor (con el usuario `admin` !)
@@ -77,16 +76,19 @@ ssh -p 2244 admin@tu.dominio.tld
 Por defecto, sólo el usuario `admin` puede conectarse en SSH en una instancia YunoHost.
 
 Los usuarios YunoHost creados vea la interfaz de administración están administrados por la base de datos LDAP. Por defecto, no pueden conectarse en SSH por razones de seguridad. Si necesitas absolutamente que uno de estos usuarios disponga de un acceso SSH, puedes utilizar el comando :
+
 ```bash
 yunohost user permission add ssh.main <username>
 ```
 
 Del mismo modo, es posible cancelar el acceso SSH de un usuario con el comando :
+
 ```bash
 yunohost user permission remove ssh.main <username>
 ```
 
 Finalmente, es posible añadir, suprimir y listar llaves SSH, para mejorar la seguridad del acceso SSH, con estos comandos :
+
 ```bash
 yunohost user ssh add-key <username> <key>
 yunohost user ssh remove-key <username> <key>
@@ -107,7 +109,7 @@ El comando `yunohost` puede ser utilizado para administrar tu servidor o realiza
 
 Los comandos YunoHost tienen este tipo de estructura :
 
-```bash
+```text
 yunohost app install wordpress --label Webmail
           ^    ^        ^             ^
           |    |        |             |

pages/02.administer/15.admin_guide/15.command_line/command_line.fr.md

@@ -18,6 +18,7 @@ page-toc:
 L'interface en ligne de commande (CLI) est, en informatique, la manière originale (et plus technique) d'interagir avec un ordinateur, comparée aux interfaces graphiques. La ligne de commande est généralement considérée comme plus complète, puissante et efficace que les interfaces graphiques, bien que plus difficile à apprendre.
 
 ## Comment se connecter ?
+
 ### Identifiant à utiliser
 
 [ui-tabs position="top-left" active="0" theme="lite"]
@@ -38,9 +39,10 @@ Durant la post-installation, vous avez défini un mot de passe d'administration.
 ### Adresse à utiliser
 
 Si vous hébergez votre serveur **à la maison** (par ex. Raspberry Pi ou OLinuXino ou vieil ordinateur)
-   - vous devriez pouvoir vous connecter à la machine en utilisant `yunohost.local` (ou `yunohost-2.local`, selon le nombre de serveurs sur le réseau). 
+
-   - si `yunohost.local` et consorts ne fonctionnent pas, il vous faut [trouver l'IP locale de votre serveur](/finding_the_local_ip).
+- vous devriez pouvoir vous connecter à la machine en utilisant `yunohost.local` (ou `yunohost-2.local`, selon le nombre de serveurs sur le réseau).
-   - si vous avez installé votre serveur à la maison mais essayez d'y accéder depuis l'extérieur du réseau local, assurez-vous d'avoir bien configuré une redirection de port pour le port 22.
+- si `yunohost.local` et consorts ne fonctionnent pas, il vous faut [trouver l'IP locale de votre serveur](/finding_the_local_ip).
+- si vous avez installé votre serveur à la maison mais essayez d'y accéder depuis l'extérieur du réseau local, assurez-vous d'avoir bien configuré une redirection de port pour le port 22.
 
 S'il s'agit d'une machine distante (VPS), votre fournisseur devrait vous avoir communiqué l'IP de votre machine.
 
@@ -87,6 +89,7 @@ Si vous souhaitez ajouter une clé publique SSH à l'utilisateur, vous devez le
 [/ui-tab]
 [ui-tab title="À partir de la ligne de commande"]
 Pour autoriser un utilisateur ou un groupe à accéder en SFTP ou en SSH :
+
 ```bash
 # SFTP
 yunohost user permission add sftp <username>
@@ -95,6 +98,7 @@ yunohost user permission add ssh <username>
 ```
 
 Pour enlever la permission :
+
 ```bash
 # SFTP
 yunohost user permission remove sftp <username>
@@ -103,11 +107,13 @@ yunohost user permission remove ssh <username>
 ```
 
 Enfin, il est possible d'ajouter, de supprimer et de lister des clés SSH, pour améliorer la sécurité de l'accès SSH, avec les commandes :
+
 ```bash
 yunohost user ssh add-key <username> <key>
 yunohost user ssh remove-key <username> <key>
 yunohost user ssh list-keys <username>
 ```
+
 [/ui-tab]
 [/ui-tabs]
 
@@ -125,7 +131,7 @@ La commande `yunohost` peut être utilisée pour administrer votre serveur ou r
 
 Les commandes YunoHost ont ce type de structure :
 
-```bash
+```text
 yunohost app install wordpress --label Webmail
           ^    ^        ^             ^
           |    |        |             |
@@ -143,25 +149,31 @@ yunohost user create --help
 vont successivement lister toutes les catégories disponibles, puis les actions de la catégorie `user`, puis expliquer comment utiliser l'action `user create`. Vous devriez remarquer que l'arbre des commandes YunoHost suit une structure similaire aux pages de la webadmin.
 
 ### La commande `yunopaste`
+
 Cette commande est utile lorsque vous voulez communiquer à une autre personne le retour d'une commande.
 
 Exemple :
+
 ```bash
 yunohost tools diagnosis | yunopaste
 ```
+
 ### Quelques commandes utiles
 
 Si votre interface web d'administration indique que l'API est injoignable, essayez de démarrer `yunohost-api` :
+
 ```bash
 systemctl start yunohost-api
 ```
 
 Si vous ne parvenez plus à vous connecter avec l'utilisateur `admin` via SSH et via l'interface web, le service `slapd` est peut-être éteint, essayez de le redémarrer :
+
 ```bash
 systemctl restart slapd
 ```
 
 Si vous avez des configurations modifiées manuellement et souhaitez connaître les modifications :
+
 ```bash
 yunohost tools regen-conf --with-diff --dry-run
 ```