Documentation for Kicksecure ™ Wiki Editors

From Kicksecure
< Dev
Jump to navigation Jump to search

LinkSuggest vs CodeMirror[edit]

Unfortunately, Extension:CodeMirror breaks Extension:LinkSuggest.

Workaround: CodeMirror can be disabled by pressing the Codemirror-icon.png.

upstream bug reports:

Links[edit]

  • Default MediaWiki Link Creation
    • clearnet → automatically adding link to web archive
    • onion → no extraneous onion archive link
      • Syntax:
        [http://www.w5j6stm77zs6652pgsij4awcjeel3eco7kvipheu6mtr623eyyehj4yd.onion Kicksecure Homepage]
      • Example: Kicksecure Homepage
    • link to web archive → no extraneous archive link
      • Syntax:
        [https://web.archive.org/web/https://www.kicksecure.com this link]
      • Example: this link
  • Technical Background:
    • This is not based on any wiki template.
    • This is thanks to link-to-archive MediaWiki Extension.
    • The simple way for wiki editors to write most links.
  • clearnet + archive + onion
    • Syntax:
      {{Archive_link|url=https://www.kicksecure.com|text=Kicksecure Homepage|onion=http://www.w5j6stm77zs6652pgsij4awcjeel3eco7kvipheu6mtr623eyyehj4yd.onion}}
    • Example: Kicksecure Homepage
  • clearnet + archive (No Onion)
    • Syntax:
      {{Archive_link|url=https://www.kicksecure.com|text=Kicksecure Homepage}}
    • Example: Kicksecure Homepage
    • Same as Default MediaWiki Link Creation.
    • In this case, Default MediaWiki Link Creation might be simpler.
  • Archived Only - In case live version is permanently unavailable.
    • {{Archive_link|url=https://web.archive.org/web/https://www.kicksecure.com|archive=copy|text=Kicksecure Homepage (Archived)}}
    • Example: Kicksecure Homepage (Archived)
  • No Archive - In case archived link would be too long, inappropriate.
    • {{Archive_link|url=https://www.kicksecure.com|text=Kicksecure Homepage|archive=none}}
    • Example: Kicksecure Homepage
  • Technical Background:
    • This is not based on wiki template archive_link. (Source code documentation under Dev/mediawiki.)
    • No MediaWiki extension is involved.
    • This is for special links, i.e. links which might be archived only (no more clearnet version available), onion only (no clearnet version available) or for links which should not automatically add a link to the web archive in special places (header, footer) for stylistic reasons.
  • Kicksecure wiki link - (similar an example above, just easier to use than writing Kicksecure onion by hand)
  • Kicksecure website link - (similar an example above, just easier to use than writing Kicksecure onion by hand)
  • Archive_link Common Usage Mistakes:
    • Protocol handler http or https is required.
    • wrong: |onion={{QubesOS_onion}}
    • correct: |onion=http://{{QubesOS_onion}}

Expand Button[edit]

<div class="toccolours mw-collapsible mw-collapsed">
For {{project_name_long}} VirtualBox import instructions, please press on expand on the right.
<div class="mw-collapsible-content">
Hidden Text Here
</div>
</div>

CodeSelect with pipes[edit]

Use

{{!}}

rather than

|

Or simply have a look at the mediawiki markup for the following example.

Exec=cat file | grep something

related: CodeSelect implementation source code documentation

pre tag with white spaces[edit]

Try making the opening tag

<pre style="white-space: pre-wrap;">
...

instead of normal pre>.

Example with pre-wrap:

   leading white space example

Example without pre-wrap:

   leading white space example

Seems currently not required with the mediawiki skin used at time of writing.

There are a number of other wrapping/whitespace options if that doesn't work for what you need.

pre tags with variables[edit]

Syntax:

<div class="pre">

</div>

Syntax example:

<div class="pre">{{project name long}} <code>{{VersionNew}}</code></div>

Live example:

Kicksecure ™ 16.0.5.3

Scrollable Tables[edit]

To make tables scrollable on mobile, the table needs to be wrapped into:

<div class="scroll-table">

</div>

Examples:

JavaScript vs no-JavaScript[edit]

Syntax example:

<div class="show-for-nojs-only">
NoScript version: Text is only show when JavaScript is not active
</div>

<div class="show-for-js-only">
JavaScript version: Text is only show when JavaScript is active
</div>

Live test:

NoScript version: Text is only show when JavaScript is not active

JavaScript version: Text is only show when JavaScript is active

Mini Navigation[edit]

Example syntax:

<div class="mininav">
* [[Documentation]]
* [[FAQ]]
* [[Support]]
* [[Advanced Documentation]]
</div>

Live example:

Live Wiki Pages Examples:

External Redirects Documentation[edit]

Setting up External Redirects[edit]

For example, https://www.whonix.org/wiki/Software was moved to https://www.kicksecure.com/wiki/Software

Using Software as an example here. Textual string Software needs to be replaced with

1. Go to migrated page from Whonix wiki:

  • Go to https://www.whonix.org/wiki/Software

2. Create the redirect to the Moved: namespace.

  • edit the page:
  • Paste.
    #REDIRECT [[Moved:Software]]
  • Save.

3. Go to the new Software stub page in the Moved: namespace.

The link which is now visible due to step 2 should now be visible.

4. Create the external redirect.

  • On https://www.whonix.org/wiki/Moved:Software
  • Paste.
{{#externalredirect: https://www.kicksecure.com/wiki/Software}}
  • Save.

5. Test the redirect.

For example, https://www.whonix.org/wiki/Software should now be re-directing to https://www.kicksecure.com/wiki/Software.

6. Done.

Redirection setup complete.

Editing Existing External Redirects[edit]

NOTE: Replace OpenPGP with the actual wiki page name.

Wiki Editors Terminology for Wiki Migration[edit]

  • copy (duplicate from Whonix wiki to Kicksecure wiki and remove Whonix specific parts from Kicksecure wiki)
  • migrate from Whonix to Kicksecure
  • sort it out

Social Media Posting[edit]

Thumbnail Link vs Normal Link[edit]

Please use "thumbnail link". Not "normal link".

Examples:

normal link, cannot use:

https://www.{{project_clearnet}}/w/images/4/44/Whonixonly.jpg

thumbnail link, can use:

https://www.{{project_clearnet}}/w/images/thumb/4/44/Whonixonly.jpg/470px-Whonixonly.jpg

Social Media Link Preview Tests[edit]

MultiWiki[edit]

Category MultiWiki is used as a tag. Wiki pages with this tag are sometimes mirrored from the Kicksecure wiki to the Whonix wiki with the assistance of automated scripting.

To add a wiki page to Category MultiWiki, the following text needs to be added to that wiki page. By convention, it should be in the footnotes or section or very bottom the footer of the wiki page.

A) If it is a wiki page, add:

[[Category:MultiWiki]]

B) If it is a wiki template, add:

<noinclude>
[[Category:MultiWiki]]
</noinclude>

Examples wiki pages that have been added to Category MultiWiki:

Examples wiki templates that have been added to Category MultiWiki:

The full list of wiki pages currently in Category MultiWiki can be found on the category page:

ReplaceText[edit]

1. Go to Special:ReplaceText.

2. If:

  • A) regex is not required: No special action required.
  • B) regex is required: To use regex, check box Use regular expressions is required. For regex examples, see below.

ReplaceText regex Examples[edit]

\(\[http\:\/\/www\.webcitation\.org\/\S{9} w\]\)
\(\[http\:\/\/www\.webcitation\.org\/\S{9} \(w\)\]\)
\[http\:\/\/www\.webcitation\.org\/\S{9} \(w\)\]
\<ref\>\s*http\:\/\/www\.webcitation\.org\/\S{9}\s*\<\/ref\>
http\:\/\/www\.webcitation\.org\/\S{9}

space removal in template invocations[edit]

4

regex:

\{\{(\w+)\s(\w+)\s(\w+)\s(\w+)\}\}

replace:

{{$1_$2_$3_$4}}

(\s means "white space".)

3

\{\{(\w+)\s(\w+)\s(\w+)\}\}
{{$1_$2_$3}}

2

\{\{(\w+)\s(\w+)\}\}
{{$1_$2}}

template rename[edit]

(?i)workstation.product.name.short
(?i)\{\{project.name\}\}

See Also[edit]



Unfinished: This wiki is a work in progress. Please do not report broken links until this notice is removed, use Search Engines First and contribute improving this wiki.