User Tools

Site Tools


wiki_authoring

This is an old revision of the document!


Wiki Authoring

Here are instructions on how to create new wiki pages on this wiki: www.dokuwiki.org/page#wiki_pages

Here are instructions on how to edit pages: www.dokuwiki.org/editing

A page showing syntax for editing wiki pages: Formatting Syntax

Draft versions

  • Saving a draftfile can be forced by pressing the preview button.
    • Recover1) a retained draftfile with Edit draft (to the right, above Old revisions).
  1. Edit draft Edit draft [e]
  2. Draft file found (heading)
    1. Recover draft Recover draft

Draft versions: www.dokuwiki.org/draft

Show pagesource

  • Review the DokuWiki pagesource.
    • Log out to view the Show pagesource option.
  1. Show pagesource Show pagesource [v]
  2. This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong. (heading)
    1. Pagesource arrows Pagesource arrows

Wiki Authoring Tips

URL Schemes

Unlike the usual URL links, such as HTTP, FTP, mailto, etc, Gemini links will now2) don't work in the SDF wiki, because it appears to not understand the protocol (which makes sense, Gemini is now not widely accepted yet at SDF) but if you don't surround a gemini link in the link markup syntax with double brackets, dokuwiki will consider // as “start italics” and mess up your document.

so if you type [[gemini://gem.sdf.org]] inline in wiki markup, it will render as

gemini://gem.sdf.org

but if you just type the url straight, as gemini://gem.sdf.org, it will be displayed as:

gemini://gem.sdf.org

headline level

It is possible to link to a headline that is omitted from the Table of Contents.

1.The Sectioning and headline documentation.Use different levels of headlines to structure your content.
a.A Profile and Rules headline example.Use the browser go back to return to Wiki Authoring.
b.Use the Show pagesource to view the Profile and Rules headline example.

playground namespace

A pagename that is saved in the wiki playground ns can display nonexistent wiki pagename links, unless a colon is used.

  1. Links within the DokuWiki playground namespace.
    1. This wiki authoring link 3) is green when viewed from the playground namespace.
      A link with `[[:`
      This [[:wiki_authoring|wiki authoring]] link is green when viewed from the playground namespace.
    2. This wiki authoring link 4) is red when viewed from the playground namespace.
      A link with `[[`
      This [[wiki_authoring|wiki authoring]] link is red when viewed from the playground namespace.
  2. A red pagename link 5) example.
    nonexistent pagename
    //a topic that doesn't exist yet//\\
    https://wiki.sdf.org/doku.php?id=playground:author:playground

Plan 9 pages

This section provides links to some SDF Wiki Plan 9 abaco, or mothra, browser pagesource examples.

Some of the Text to Image Conversions do not work well with the abaco, or mothra, browsers.

  1. View CAUTION with the abaco browser to demonstrate the broken Text to Image Conversions.
    1. Impression: inspiring
      abaco CAUTION:
      [:!:] CAUTION [:!:] CAUTION [:!:] CAUTION [:!:]
  2. View CAUTION with the mothra browser to demonstrate the broken Text to Image Conversions.
    1. Impression: uninspiring
      mothra CAUTION:
      [img: https://wiki.sdf.org/lib/images/smileys/exclaim.svg: unknown image type]
      CAUTION[img: https://wiki.sdf.org/lib/images/smileys/exclaim.svg: unknown image type]
      CAUTION[img: https://wiki.sdf.org/lib/images/smileys/exclaim.svg: unknown image type]
      CAUTION[img: https://wiki.sdf.org/lib/images/smileys/exclaim.svg: unknown image type]

The supported ordered and unordered lists will look different when viewed with the abaco, or mothra, browsers.

The supported Tables can work well while the headers may work differently when viewed with the abaco, or mothra, browsers.

xOne method is to review a playground draft with the mothra browser first, then an abaco browser second, if needed.
1)
After a browser crash
2)
Membership included gemini in the SDF wiki conf/scheme.local.conf file.
3)
With a colon [[:wiki_authoring|wiki authoring]]
4)
Without a colon [[wiki_authoring|wiki authoring]]
5)
A link without a contiguous underline.
6)
NetSurf is a free, open source web browser.
7)
Redirect to document page on plan9.io, view wiki for details.
wiki_authoring.1700636924.txt.gz · Last modified: 2023/11/22 07:08 by hc9