mirror of
https://github.com/go-gitea/gitea.git
synced 2024-08-30 16:17:28 +02:00
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. |
||
---|---|---|
.. | ||
_index.en-us.md | ||
_index.zh-cn.md | ||
_index.zh-tw.md | ||
adding-legal-pages.en-us.md | ||
adding-legal-pages.zh-cn.md | ||
backup-and-restore.en-us.md | ||
backup-and-restore.zh-cn.md | ||
backup-and-restore.zh-tw.md | ||
cmd-embedded.en-us.md | ||
cmd-embedded.zh-cn.md | ||
command-line.en-us.md | ||
command-line.zh-cn.md | ||
config-cheat-sheet.en-us.md | ||
config-cheat-sheet.zh-cn.md | ||
customizing-gitea.en-us.md | ||
customizing-gitea.zh-cn.md | ||
email-setup.en-us.md | ||
email-setup.zh-cn.md | ||
environment-variables.en-us.md | ||
environment-variables.zh-cn.md | ||
external-renderers.en-us.md | ||
external-renderers.zh-cn.md | ||
fail2ban-setup.en-us.md | ||
fail2ban-setup.zh-cn.md | ||
git-lfs-support.en-us.md | ||
git-lfs-support.zh-cn.md | ||
https-support.en-us.md | ||
https-support.zh-cn.md | ||
logging-config.en-us.md | ||
logging-config.zh-cn.md | ||
mail-templates.en-us.md | ||
mail-templates.zh-cn.md | ||
repo-indexer.en-us.md | ||
repo-indexer.zh-cn.md | ||
reverse-proxies.en-us.md | ||
reverse-proxies.zh-cn.md | ||
search-engines-indexation.en-us.md | ||
search-engines-indexation.zh-cn.md | ||
signing.en-us.md | ||
signing.zh-cn.md |