mirror of https://github.com/go-gitea/gitea.git
d7e669c371
The cheat sheet uses the `asciidoc` markup language to demonstrate how to set up third party markup renderers. The current example has the following issues: - It promotes a legacy tool that does not handle modern AsciiDoc specifications - It does not account for embedded preview renders - It has no safety restrictions By switching to `asciidoctor`, uses are suggested to utilize de facto/standard tooling for AsciiDoc. The `--embedded` parameter will strip out HTML tags that contain the document (such as `<html></html>`) which aren't necessary for the render, and actually end up as text in the document if left in. The `--safe-mode` parameter (of which there are several profiles) imposes [certain policies](https://docs.asciidoctor.org/asciidoctor/latest/safe-modes/) on the files it ingests and what the resulting output looks like. GitHub itself uses the `secure` profile (the highest), which can be a good starting point for those who are uncertain of what to do. By default, if no mode is specified when `asciidoctor` runs it defaults to `unsafe`, i.e. no safety guidelines at all. |
||
|---|---|---|
| .. | ||
| administration | ||
| contributing | ||
| development | ||
| help | ||
| installation | ||
| usage | ||
| actions.en-us.md | ||
| administration.en-us.md | ||
| administration.fr-fr.md | ||
| administration.zh-cn.md | ||
| administration.zh-tw.md | ||
| contributing.en-us.md | ||
| contributing.fr-fr.md | ||
| contributing.zh-tw.md | ||
| development.en-us.md | ||
| development.zh-cn.md | ||
| development.zh-tw.md | ||
| help.en-us.md | ||
| help.fr-fr.md | ||
| help.zh-cn.md | ||
| help.zh-tw.md | ||
| installation.en-us.md | ||
| installation.fr-fr.md | ||
| installation.zh-cn.md | ||
| installation.zh-tw.md | ||
| packages.en-us.md | ||
| search.de-de.md | ||
| search.en-us.md | ||
| search.fr-fr.md | ||
| search.nl-nl.md | ||
| search.pt-br.md | ||
| search.zh-cn.md | ||
| search.zh-tw.md | ||
| usage.en-us.md | ||
| usage.zh-cn.md | ||
| usage.zh-tw.md | ||