Skip to content

First class support for AsciiDoc wiki

Description

We support creating wiki in AsciiDoc format, but there a few issues which prevent the process from being as smooth as creating wiki in Markdown:

  • In the wiki editor we say:

    To link to a (new) page, simply type [Link Title](page-slug)

This syntax does not work for AsciiDoc (see gitlab-foss#18287 (moved)). A working syntax for AsciiDoc is link:other-page[here] (http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#links)

  • Wiki editor preview does not render AsciiDoc (see gitlab-foss#1193 (moved))
  • "Add italic text", "Add a task list" and "Attach a file" do not work in AsciiDoc

Proposal

  • Display correct hint how to create a link when "AsciiDoc" is selected in the dropdown
  • Make sure that relative links work when wiki is displayed in "Project" tab - see gitlab-foss#23806 (closed)
  • Do not display the rich editor when "AsciiDoc" is selected (no Preview tab, no buttons for inserting elements, no Attach file) - first iteration

Links

See gitlab-foss#24042 (moved) - analogous issue for RDoc