User Tools

Site Tools


wiki_authoring

Wiki Authoring

If you would like to be able add or edit pages here, email membership@sdf.org (mailto link).

Here are instructions on how to create new wiki pages, and namespaces, on this wiki: www.dokuwiki.org/page#create_a_page, www.dokuwiki.org/namespaces#creating_namespaces

Here are instructions on how to edit, and delete, pages: www.dokuwiki.org/editing#page_editing, www.dokuwiki.org/page#delete_a_page

The Character picker Toolbar Button is worth remembering. It's located above The Edit Window edit area.

eight useful characters
“ ” ‘ ’ – … → •‚ and a very useful character combination: ‘''prompt''’, unlike this '''example'''
  • useful character combinationprompt’ is unlike 'example'
  • Default Text to HTML Conversions for these characters: -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) ...
    • An offline Find and Replace can locate characters from the Character picker, unlike the mentioned Text to HTML Conversions.

A page showing syntax for editing wiki pages: Formatting Syntax

Draft versions

  • Saving a draftfile can be forced by pressing the preview button.
    • Recover 1) 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
  • Old revisions Old revisions [o]
    • The old revisions list link result is not the same as the Old revisions icon result.
      `old revisions` list link example
      This page does not exist anymore
       
      You've followed a link to a page that no longer exists. You can check the list of old revisions to see when and why it was deleted, access old revisions or restore it.

Draft versions: www.dokuwiki.org/draft

Show pagesource

  • Review the DokuWiki pagesource.
    • Log out to view the Show pagesource option.
  1. Show pagesource 2) 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

Fullscreen Media Manager

The Fullscreen Media Manager layout is divided on three panes.

  1. - Upload
    1. - To create subnamespaces, prepend them to your filename separated by colons after you selected the files.
  1. - Upload – Upload to [root]
    1. - Select files… (button)
      1. - subnamespace_dir:filename_example-1.png
    2. - Upload (button) – results
      `Namespaces` Choose namespace tab example
       [–] [root]
           [+] subnamespace_dir:filename_example-1.png

for the blind

Wiki Authoring Tips

URL Schemes

Converting

An idea for converting existing documents: Convert HTML to DokuWiki

  • Pandoc [:FIXME:] 3)
    pandoc example
    pandoc -s -r html https://www.dokuwiki.org/tips:htmltowiki -t dokuwiki > tips.txt

Diagrams

==== begin the example ====

Unlike the usual URL links, such as HTTP, FTP, mailto, etc, Gemini links will now 6) 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:

==== end of the example ====

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 8) 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 9) 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 10) 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 =====

xTHIS headline IS A DRAFT

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

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

  1. View the CAUTION headline with the abaco browser to demonstrate the broken Text to Image Conversions.
    1. Impression: inspiring
      abaco CAUTION:
      [:!:] CAUTION [:!:] CAUTION [:!:] CAUTION [:!:]
  2. View the CAUTION headline 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.

Headline viewed
with abaco 15) 16)
Ordered and unordered lists
impression
inspiring uninspiring
ARPA
Common File Commands
Reference book
Headline viewed
with mothra 17) 18)
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.

  1. View the Plan 9, plan9front, Boot Camp headline with the abaco browser to demonstrate the tables, rows, and headers.
    1. Impression: inspiring
  2. View the Plan 9, plan9front, Boot Camp headline with the mothra browser to demonstrate the tables, rows, and headers.
    1. Impression: uninspiring
  1. View the 9front - Plan9front headline with the abaco browser to demonstrate the tables, rows, and headers.
    1. Impression: inspiring
  2. 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:] 19).

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.

Authoring Tips

  1. 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 SessionInterlisp Example Session on TWENEX
b. Interlisp EditorThe Interlisp Editor
2. CMS and Wiki Options That Only Require ARPA Membership
a. • Wikis
• BrutalWiki: …Here's a [https] demo running on SDF

Authoring Tips

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

basement Wiki

Yes, if you just want to ‘try it out’ you can do that in your basement
all alone .. single user, but when you’re part of a community
  1. DokuWiki on a Stick — the basement
    1. basement Wiki plugins for review: An unscheduled study
So summarize: DokuWiki on-a-stick is for personal use only.
It is meant to be run locally for a single user.

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

1)
After a browser crash
2)
Ctrl+F the wiki page source after using Show pagesource.
3) , 16) , 18)
The [:FIXME:] is interchangeable with a [FIXME], for the abaco, and mothra browsers. FIXME
4)
A relevant bboard is <TUTORIALS>, where a pending review might surface.
5)
The admin page was not created by admin.
6)
Membership included gemini in the SDF wiki conf/scheme.local.conf file.
7)
An SDF DokuWiki upgrade can overwrite a previous edit, where gemini was included in the SDF wiki conf/scheme.local.conf file.
8)
With a colon [[:wiki_authoring|wiki authoring]]
9)
Without a colon [[wiki_authoring|wiki authoring]]
10)
A link without a contiguous underline.
11) , 15) , 17)
The [:!:] is interchangeable with a [CAUTION], for the abaco, and mothra browsers. :!:
13)
NetSurf is a free, open source web browser.
14)
Redirect to document page on plan9.io, view wiki for details.
20)
It is meant to be run locally for a single user (without a network drive).
wiki_authoring.txt · Last modified: by hc9