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.
- Recover¹⁾ a retained draftfile with Edit draft (to the right, above Old revisions).

Edit draft
Draft file found (heading)
1. Recover draft

Draft versions: www.dokuwiki.org/draft

Show pagesource

Review the DokuWiki pagesource.
- Log out to view the Show pagesource option.

Show pagesource ²⁾
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

for the blind

DokuWiki pagesource examples from Libraries for the Blind and Print Disabled

Wiki Authoring Tips

URL Schemes

URL Schemes: www.dokuwiki.org/urlschemes

Gemini links

Unlike the usual URL links, such as HTTP, FTP, mailto, etc, Gemini links will now³⁾ ~~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.

Links within the DokuWiki playground namespace.
1. This wiki authoring link ⁴⁾ 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 ⁵⁾ 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.

A red pagename link ⁶⁾ example.

nonexistent pagename

//a topic that doesn't exist yet//\\
https://wiki.sdf.org/doku.php?id=playground:author:playground

Plan 9 pages

===== Plan 9 pages =====

x	THIS headline IS A DRAFT

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

x

abaco, mothra, NetSurf ⁹⁾:

none supports perfectly the most complex(or broken) websites ¹⁰⁾

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

View the CAUTION headline with the abaco browser to demonstrate the broken Text to Image Conversions.
1. Impression: inspiring
  abaco CAUTION:
  [:!:] CAUTION [:!:] CAUTION [:!:] CAUTION [:!:]

View the CAUTION headline with the mothra browser to demonstrate the broken Text to Image Conversions.

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.

Headline viewed with abaco ¹¹⁾ ¹²⁾	Ordered and unordered lists impression
	inspiring	uninspiring
ARPA		✔
Common File Commands		✔
Reference book	✔

Headline viewed with mothra ¹³⁾ ¹⁴⁾	Ordered and unordered lists impression
	inspiring	uninspiring
ARPA	✔
Common File Commands	✔
Reference book	✔

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

View the Plan 9, plan9front, Boot Camp headline with the abaco browser to demonstrate the tables, rows, and headers.
1. Impression: inspiring
View the Plan 9, plan9front, Boot Camp headline with the mothra browser to demonstrate the tables, rows, and headers.
1. Impression: uninspiring

View the 9front - Plan9front headline with the abaco browser to demonstrate the tables, rows, and headers.
1. Impression: inspiring
View the 9front - Plan9front headline with the mothra browser to demonstrate the tables, rows, and headers.
1. Impression: uninspiring

1.	One method is to review a playground draft with the mothra browser first, then an abaco browser second, if needed.
a.	Use a footnote: example [:8-O:] ¹⁵⁾.

Plan 9 extension

One might roll (one's) eyes when reviewing a Plan 9 extension tutorial headline in the distant future.
Two Tutorial Projects are described in detail. The SDF plan9front server can act as a repository
for additional educational content. These content sections, or headlines, may resemble tutorial content.

x	Discoveries in Programming
x	Discoveries in Hardware

Authoring Tips

Discoveries Authoring Tips welcome.
sample Discoveries html format
```
A sample Discoveries format may apply.
```

Wiki section extension

One might roll (one's) eyes when reviewing a Wiki section extension tutorial headline in the distant
future. Two Tutorial Projects are described in detail. Another SDF server can act as a repository
for additional educational content. These content section extensions may resemble tutorial content.

1.	TWENEX Interlisp Tutorial
a.	Example Session – Interlisp Example Session on TWENEX
b.	Interlisp Editor – The Interlisp Editor

Authoring Tips

Section Extension Authoring Tips welcome.
sample Section Extension html format
```
A sample Section Extension format may apply.
```

This wiki page was reviewed with the Plan 9 abaco, and mothra, browsers.

¹⁾

After a browser crash

²⁾

Ctrl+F the wiki page source after using Show pagesource.

³⁾

Membership included gemini in the SDF wiki conf/scheme.local.conf file.

⁴⁾

With a colon [[:wiki_authoring|wiki authoring]]

⁵⁾

Without a colon [[wiki_authoring|wiki authoring]]

⁶⁾

A link without a contiguous underline.

⁷⁾ , ¹¹⁾ , ¹³⁾

The [:!:] is interchangeable with a [CAUTION], for the abaco, and mothra browsers.

⁸⁾ , ¹⁵⁾

graphical equivalents

⁹⁾

NetSurf is a free, open source web browser.

¹⁰⁾

Redirect to document page on plan9.io, view wiki for details.

¹²⁾ , ¹⁴⁾

The [:FIXME:] is interchangeable with a [FIXME], for the abaco, and mothra browsers.