Wiki: Difference between revisions

From Noisebridge
Jump to navigation Jump to search
← Older edit
undoMcint (talk | contribs)
Bureaucrats, confirmed, emailconfirmed, Interface administrators, Administrators
3,034 edits
VisualWikitext
Mcint (talk | contribs)
Bureaucrats, confirmed, emailconfirmed, Interface administrators, Administrators
3,034 edits
m →How to start editing the Wiki: fix auto-numbered list
Mcint (talk | contribs)
Bureaucrats, confirmed, emailconfirmed, Interface administrators, Administrators
3,034 edits
→Wiki Server: add contribution domains enumeration
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{wikipages}}
{{wikipages}}
{{headerbox}}'''This is a Wiki page''' dedicated to our [[Talk:Noisebridge| Wiki]] explaining how to edit the wiki including this wiki page.
{{headerbox}}'''This is a Wiki page''' dedicated to our [[Talk:Noisebridge| Wiki]] explaining how to edit the wiki including this wiki page.
*'''CONTENT MAINTAINERS:''' [[User:Mcint]], [[User:Lxpk]], [[User:Hungry bogart]], more needed
*'''CONTENT MAINTAINERS:''' [[User:Mcint]], [[User:Lxpk]], [[User:Hungry bogart]], more needed
Line 11: Line 10:
=How to start editing the Wiki=
=How to start editing the Wiki=
# Get a wiki account!  
# Get a wiki account!  
#* Either, request that an existing wiki user [[Special:InviteSignup|Invite you to the wiki]] by giving them your email (most can) in-person, by email, or via a chat app,
#* [[Special:RequestAccount|'''Request account''']] from the top-right corner of any page. ''Note the bio will become an initial [[mw:Help:User page|User_page (mw:Help:)]]. It needs to include something like a minimum of 4-8 words, 40 characters to continue the process. Include enough for someone you met to recognize you from your interests.''[[File:Screenshot 20240820 222142.png|alt=Image of request account link on page|thumb|[[Special:RequestAccount|Request an Account]], screenshot illustrating link, in upper-right corner of page.]]
#* Or [[Special:RequestAccount|request an account]] ''([[Special:CreateAccount|Create an account]] now redirects there)'', and '''immediately notify a wiki maintainer'''/[[Special:ActiveUsers|active user]], so they can [[Special:ConfirmAccounts|confirm your account]] ''(from its place hidden among hundreds of spam requests)''.
#**'''Immediately notify a wiki maintainer'''/[[Special:ActiveUsers|active user]] (in person, or via [[Discord]] in the <code>#wiki</code> channel, or [[Slack]]), so they can [[Special:ConfirmAccounts|'''confirm your account''']]. ''(We get dozens of spam requests per day, hundreds sit in the 1-month backlog, 1-month archive queues.)''
# Create a brief user page (Click the link at the top right with your username to the left of "Talk" that goes to a User:Username page.
#**'''When a wiki admin creates the account''', our [[MediaWiki]] software will '''send you an email with a temporary password''', from <code>...@noisebridge.net</code>.
#***''If you have a gmail account,'' '''''check Spam''' for this message''. '''Log in''' to the wiki & '''update your password'''.
#***Wiki admin will also ensure you have <code>[[Special:ListGroupRights|confirmed]]</code> permission. ''On each [[Special:MyPage|User page]], the sidebar footer '''Tools''' section, has a link to '''[[Special:UserRights|Change user groups]].''' (This link also resides in the [[Special:SpecialPages|'''Special pages''']] directory page, in the sidebar's bottom '''Tools''' section, on every page. '''[[Special:SpecialPages]]''' is best navigated by Ctrl/Cmd-F on-page search.)'' ''List recent users, to view their permissions, at [https://www.noisebridge.net/wiki/Special:ListUsers?username=&group=&creationSort=1&desc=1&wpsubmit=&wpFormIdentifier=mw-listusers-form&limit=50 Special:ListUsers -- sort by created time, descending].''
#**'''Congratulations, the hard part is done! Let the fun begin!'''
#*''<small>Note alternative and past processes include:</small>''
#**''<small>[[Special:CreateAccount|Create an account]] (default) now redirects to [[Special:RequestAccount]].</small>''
#** ''<small>Seek an [[Special:InviteSignup|Invitation to Signup]] from an existing wiki user, by giving them your email (most can) in-person, by email, or via a chat app,</small>''
# Create a brief '''[[mw:Help:User page|user page]]''' ''(Click the link at the top right with your username to the left of "[[Special:MyTalk|Talk]]" that goes to a [[Special:MyPage|User:[Username]]] page.)''[[File:User - User talk wiki screenshot.png|alt=Screenshot of upper-right corner of page in logged-in view, showing "[User]" and "Talk" links among others.|thumb|User/User_talk screenshot, showing logged-in view, of page.]]
## Mention what activities you're interested in or working on.
## Mention what activities you're interested in or working on.
## If you want to coordinate with others, provide pseudonymous contact info for yourself if you're comfortable sharing it.  
## If you want to coordinate with others, provide pseudonymous contact info for yourself if you're comfortable sharing it.
## It does not have to have personally identifying info, pseudonyms or no contact info is fine if you want to remain private.
##It does not have to have personally identifying info, pseudonyms or no contact info is fine if you want to remain private.
## Most people just put the handle or name they go by around the space and usernames for [[Slack]]/[[Discord]]/[[Discuss]].
## Most people just put the handle or name they go by around the space and usernames for [[Slack]]/[[Discord]]/[[Discuss]].
# [[Volunteer]] to help maintain some part of Noisebridge by editing wiki pages.
#Once you're <code>[[Special:ListGroupRights|confirmed]]</code> you can create pages, update the [[Events]] page, & add yourself as a [[Maintainers|Maintainer]] for a [[Guild]], [[Project]], or [[Working Group]].
#[[Volunteer]] to help maintain some part of Noisebridge by editing wiki pages.
# Join the [[Documentation]] working group to get more involved in improving Noisebridge docs including [[Wiki]] and [[Signage]].
# Join the [[Documentation]] working group to get more involved in improving Noisebridge docs including [[Wiki]] and [[Signage]].


== How to edit the Wiki pages ==
=== How to edit the Wiki pages===  
* You can edit most any page by clicking '''Edit'''.
*You can edit most any page by clicking '''Edit'''.
* You can figure out who else is recently maintaining a page by clicking '''View history''.
*You can figure out who else is recently maintaining a page by clicking '''View history''.
*[https://www.mediawiki.org/wiki/Help:Formatting Formatting] page of mediawiki will tell you how to compose.
*[https://www.mediawiki.org/wiki/Help:Formatting Formatting] page of mediawiki will tell you how to compose.
* Some pages are protected so only logged in users or admins can edit them.
*Some pages are protected so only logged in users or admins can edit them.
* You should create an account and summarize your edits whenever possible to make collab with other editors work better.
*You should create an account and summarize your edits whenever possible to make collab with other editors work better.


== How to help improve the Wiki ==
=== How to help improve the Wiki ===
Your best bet with wikis is always to reuse existing code in order to write better pages.</br>
Your best bet with wikis is always to reuse existing code in order to write better pages.<br>
* [https://discuss.noisebridge.info/t/post-here-wiki-out-of-date-info-dead-pages/1522/ See this discussion] on pruning and improving our wiki pages.
*[https://discuss.noisebridge.info/t/post-here-wiki-out-of-date-info-dead-pages/1522/ See this discussion] on pruning and improving our wiki pages.
* Integrate orphaned pages into the menu system by putting the appropriate { { guildmenutemplate } } at the top.
*Integrate orphaned pages into the menu system by putting the appropriate { { guildmenutemplate } } at the top.
** Edit the menu you added it under with a link to it, especially if it is currently relevant or in a historical menu category like [[Lore]].
**Edit the menu you added it under with a link to it, especially if it is currently relevant or in a historical menu category like [[Lore]].
** If it is historic, edit the main page in the submenu category with links to it under a Historic header at the bottom of the page instead of a menu link.
**If it is historic, edit the main page in the submenu category with links to it under a Historic header at the bottom of the page instead of a menu link.
* Mark outdated pages with the { { historic } }(no spaces between curly braces) template.
*Mark outdated pages with the { { historic } }(no spaces between curly braces) template.
* Mark parts of Noisebridge not fully constructed as { { construction } }
* Mark parts of Noisebridge not fully constructed as { { construction } }
* Create new categories and embed their tags in a template with a visible box like those.
* Create new categories and embed their tags in a template with a visible box like those.


== How to make the menus==
===How to make the menus===
# Most pages have menu header templates at the top which are nested hierarchically.
#Most pages have menu header templates at the top which are nested hierarchically.
# Put a relevant menu header at the top like this: <pre>{{projects}}</pre>
#Put a relevant menu header at the top like this: <pre>{{projects}}</pre>
# Submit and click the link to the missing template if it doesn't exist to create it.
#Submit and click the link to the missing template if it doesn't exist to create it.
# Start a menu with a template code to the hierarchical menu above it if any.
#Start a menu with a template code to the hierarchical menu above it if any.
# Follow that on a new line with the numbered box tag corresponding to the level of hierarchy in the menu for the correct rainbow color:  
# Follow that on a new line with the numbered box tag corresponding to the level of hierarchy in the menu for the correct rainbow color:
<pre>{{parentmenu}}
<pre>{{parentmenu}}
{{box2}} '''[[MenuTitle]]''' | [[Link1]] | [[Link2]] | [[:Template:MenuTitle|Edit]]  
{{box2}} '''[[MenuTitle]]''' | [[Link1]] | [[Link2]] | [[:Template:MenuTitle|Edit]]  
{{boxend}}</pre>
{{boxend}}</pre>  
# Separate menu links by | characters.
#Separate menu links by | characters.
# Simplify menu link names using pipes like this: <pre> [[Actual_Link|Clean looking link title]]</pre>
#Simplify menu link names using pipes like this: <pre> [[Actual_Link|Clean looking link title]]</pre>
*Use alphabetical link order if there isn't a specific flow that makes sense.
*Use alphabetical link order if there isn't a specific flow that makes sense.
# Menu templates they should have an Edit link at the end linking to <pre>[[:Template:Templatename|Edit]]</pre>
#Menu templates they should have an Edit link at the end linking to <pre>[[:Template:Templatename|Edit]]</pre>


= Wiki Content =
=Wiki Content=
[[Wiki/Projects]]
[[Wiki/Projects]]


== Important Editing Links==
[[Ontology]] covers the structural patterns of the wiki, in the work of [[wp:ontology]], reaching for the simplest way to structure the shared knowledge here, to help participants keep the wiki up to date, through ease of navigation and understanding, and consistency in organization.
 
==Quick Reference==
===Important Sitewide Editable Resources===
*[[MediaWiki:Common.css]]
*[[MediaWiki:Common.css]]
*[[MediaWiki:Sidebar]]
*[[MediaWiki:Sidebar]]
Line 69: Line 79:
*[https://www.noisebridge.net/wiki/Special:AllPages?from=&to=&namespace=10 All templates]
*[https://www.noisebridge.net/wiki/Special:AllPages?from=&to=&namespace=10 All templates]
*[[:Template:Boxstart|boxstart template]]
*[[:Template:Boxstart|boxstart template]]
*[[:Template:boxes|boxes template|]] is new self-descriptive root of hierarchy, for color reference, and self-documenting on headerbox templates
*[[:Template:Box|box template]]
*[[:Template:Box|box template]]
*[[:Template:Box1|box1 template]]
*[[:Template:Box1|box1 template]]
Line 88: Line 99:


===Categories===
===Categories===
Categories automatically recognize membership of any page containing a live link to the category, and MediaWiki shows categories ''(and derived/indirect(ly-included) categories?)'' in the footer.
Categories automatically recognize membership of any page containing a live link to the category, and MediaWiki shows [[mw:categories|categories]] in the footer ''(whether directly tagged, or included via [[mw:template|template]] instantiations)''.


Using Categories:
Using Categories:


* To include a link to Category pages, for visibility & helping users navigate, use the Category template with <code>:</code> prefix:
*To include a link to Category pages, for visibility & helping users navigate, use the Category template with <code>:</code> prefix:
** <code><nowiki>[[:Category:ActiveUsers]]</nowiki></code> produces [[:Category:ActiveUsers]],
**<code><nowiki>[[:Category:ActiveUsers]]</nowiki></code> produces [[:Category:ActiveUsers]],
** <code><nowiki>[[:Category:5MoF]]</nowiki></code> produces [[:Category:5MoF]] (case-sensitive)
**<code><nowiki>[[:Category:5MoF]]</nowiki></code> produces [[:Category:5MoF]] (case-sensitive)


Other variants of linking syntax and template invocation, include ([[mw:transclude|transclude]]) category page content:
Other variants of linking syntax and template invocation, include ([[mw:transclude|transclude]]) category page content:
* <code><nowiki>[[Category:5MoF]]</nowiki></code>
*<code><nowiki>[[Category:5MoF]]</nowiki></code>
* <code><nowiki>[[:Category:5MoF]]</nowiki></code> - linking to category syntax
*<code><nowiki>[[:Category:5MoF]]</nowiki></code> - linking to category syntax
* <code><nowiki>{{Category:5MoF}}</nowiki></code>
*<code><nowiki>{{Category:5MoF}}</nowiki></code>
* <code><nowiki>{{:Category:5MoF}}</nowiki></code>
*<code><nowiki>{{:Category:5MoF}}</nowiki></code>


Categories page contents cannot be  
Categories page contents cannot be  
*[https://www.noisebridge.net/wiki/Special:AllPages?from=&to=&namespace=14 All categories]
*[https://www.noisebridge.net/wiki/Special:AllPages?from=&to=&namespace=14 All categories]


== CSS Styling ==
==CSS Styling==
===HTML Colors===
===HTML Colors===
We use a rainbow of pastel hues for boxes:
We use a rainbow of pastel hues for boxes:  
* #FF9AA2,  
*#FF9AA2,
*Pastel backgrounds: #FFB7B2 #FFDAC1 #E2F0CB #B5EAD7 #C7CEEA.
*Pastel backgrounds: #FFB7B2 #FFDAC1 #E2F0CB #B5EAD7 #C7CEEA.
*Border colors: #FFFF63 #FEB144 #9EE09E #9EC1CF #CC99C9
*Border colors: #FFFF63 #FEB144 #9EE09E #9EC1CF #CC99C9
[[File:Rainbowcolorcodes.jpg]]
[[File:Rainbowcolorcodes.jpg]]


= Wiki Server =
==Page Previews & Navigation Popup Gadget==
== How the Wiki server is setup ==
Since [[Proposed_wiki_changes#2023|2023]], and verifiable at [[Special:Version]] we have [[mw:Page Previews]] enabled (specifically [[mwe:Popups]] ''& [[mwe:PageImages]]'') extension installed, and enabled for logged out users and default user configuration (nominally, possibly rate limits or other [[anti-crawler]] settings might newly conflict).
 
Editors can also use [[wp:WP:Tools/Navigation_popups]]. If logged-in, you can enable it in your <code>Preferences >> Gadgets</code> tab, [[Special:Preferences#mw-prefsection-gadgets]].
 
===Conflicts with [[template:headerbox|headerbox]] use===
Page Previews relies on at least 2 extensions for extracting text and images. The text extraction plugin ([[mw:Extension:TextExtracts]]), uses some carefully developer heuristics to part out irrelevant context at the start of a page, so that it can display a crisp summary to users hovering on mouseover.
 
====Lessons learned====
In the interest of keeping the wiki editable and maintainable, it's helpful to use semantically appropriate template names for the level of page. <code><nowiki>{{introBox}}</nowiki></code> (or <code><nowiki>{{box/intro}}</nowiki></code>) for the elements, would help distinguish from [[Template:Home]] or multi-level, navigation headerbox use—which is pretty semantically different from page introduction.
 
There's a helpful pattern in [[template:t|<code><nowiki>{{t}}</nowiki></code>]], that can, with judicious use of '''Show preview''', help editors navigate to helpful & appropriate templates within the context of editing a single page—and without the need to memorize our wiki's whole library of particular key words & pages, nor toggle to other pages merely for help with local wiki syntax.
 
=Wiki Server=
==How the Wiki server is setup==
*[[Special:Version]] tells you all about how the site is setup, including installed [https://www.mediawiki.org/wiki/Manual:Extensions extensions].
*[[Special:Version]] tells you all about how the site is setup, including installed [https://www.mediawiki.org/wiki/Manual:Extensions extensions].




== Possible additions to this wiki ==
==Possible additions to this wiki ==
* [https://github.com/timwaters/omniauth-mediawiki Oauth] will allow us to integrate login from this wiki to our Discourse instance using [https://github.com/paviliondev/discourse-wikimedia-auth/ wikimedia-auth plugin] and to https://projects.noisebridge.info [https://github.com/wikimedia/phabricator-extensions with this].
*[https://github.com/timwaters/omniauth-mediawiki Oauth] will allow us to integrate login from this wiki to our Discourse instance using [https://github.com/paviliondev/discourse-wikimedia-auth/ wikimedia-auth plugin] and to https://projects.noisebridge.info [https://github.com/wikimedia/phabricator-extensions with this].
* [https://www.mediawiki.org/wiki/Extension:StopForumSpam StopForumSpam] extension for helping limit new user registration spam.
*[https://www.mediawiki.org/wiki/Extension:StopForumSpam StopForumSpam] extension for helping limit new user registration spam.
* <del>Define how to delete users with no contributions.</del> Done, with mediawiki maintenance scripts.
*<del>Define how to delete users with no contributions.</del> Done, with mediawiki maintenance scripts.
 
*[[User:Mcint/WikiMaxxing]]
 
=Wiki Contribution Domains=
 
Many places someone can meaningfully contribute to the wiki.
 
* Content -- subject-matter content about the space -- ''this looks like:'' editing relevant wiki pages to improve a reader's understanding of the outside world
** (Talk pages, discussion)
** Content-structure -- templates, categories, guilds, maintainers -- helping track people who make updates, and the links that others navigate to build up pages.
** (Preferences, scripts, & styling -- tested & developed in private views on your own account, before possibly sharing later. interwiki link configuration.
* MediaWiki configuration -- (LocalSettings.php), Extensions, maintenance scripts, database, php-object & page caching
** web server configuration, caching, currently Caddy -- (HAProxy could support better load shedding behavior)


* [[User:Mcint/WikiMaxxing]]
Factors of similarity include:
* Blast radius -- number of people: 1, many, all / defaults.  User:[you]/custom.css, User:[you]/custom.js, ...
* Blast radius -- number of pages: 1, many, all.  Extensions or features that break, or make the wiki unavailable, increase load to unusability.


=Work Tracking=
=Tracking Projects=
==Status==
==Status==
* [[wp:Template:Navbox]]: needs a bunch of extensions. Some installed, in-progress. --[[User:Mcint|Mcint]] ([[User talk:Mcint|talk]]) 20:40, 10 December 2023 (PST)
*[[wp:Template:Navbox]]: needs a bunch of extensions. Some installed, in-progress. --[[User:Mcint|Mcint]] ([[User talk:Mcint|talk]]) 20:40, 10 December 2023 (PST)
==Changelog (minor)==
==Changelog==
A log of changes for coordination around the wiki (most-recent first). More major changes have another home.
A log of changes for coordination around the wiki (most-recent first). ''(More major changes have another home -- should have another home, linked here/ and back).''
* Enabled timezones today, in wiki software. --[[User:Mcint|Mcint]] ([[User talk:Mcint|talk]]) 20:40, 10 December 2023 (PST)
 
* Enabled [[mw:Extension:InputBox]] to try out page creation from on-page input boxes. --[[User:Mcint|Mcint]] ([[User_talk:Mcint|talk]]) [[mw:help:sign|<code><nowiki>--~~</nowiki><nowiki>~~</nowiki></code>]] 17:19, 21 January 2025 (PST)
 
*Enabled [[mw:Extension:MultimediaViewer|Extension:MultimediaViewer]] to support better image viewing & [[mw:Extension:BetaFeatures]] to support phased roll-out, or trying, of new extension features --[[User:Mcint|Mcint]] ([[User talk:Mcint|talk]]) 16:45, 12 May 2024 (PDT)
 
*Enabled [[mw:Extension:VisualEditor|Extension:VisualEditor]], with [[wp:WYSIWYG|WYSIWYG]] editing & an on-page image uploader. Also added [[mw:Extension:CharInsert|Extension:CharInsert]] to insert helpful bits of syntax when editing wikitext. --[[User:Mcint|Mcint]] ([[User talk:Mcint|talk]]) 23:10, 8 May 2024‎ (PST)
 
*Added a favicon.ico a few days ago! Working on some issues with Claudebot crawler (mainly) taking down the site, from unsustainable load. --[[User:Mcint|Mcint]] ([[User talk:Mcint|talk]]) 01:33, 29 April 2024 (PDT)
 
*Enabled timezones today, in wiki software. --[[User:Mcint|Mcint]] ([[User talk:Mcint|talk]]) 20:40, 10 December 2023 (PST)
 
{{DocsWG}}
 
==Subpages==
{{subpages}}
 
[[Special:PrefixIndex/Category:Wiki]]:
{{Special:PrefixIndex/Category:Wiki}}
 
more loosely related, [[Special:PrefixIndex/Template:Wiki]]:
{{Special:PrefixIndex/Template:Wiki}}

Latest revision as of 14:15, 10 March 2026

Noisebridge | About | Visit | 272 | Manual | Contact | Guilds | Stuff | Events | Projects | Meetings | Donate E
Communications Channels | Wiki | Discord | Slack (by invitation) | Jitsi | Pad | Meetup | Github | VR | 5MoF | YouTube | Blog | Zine | Contacts | Guestbook | BBS V ·T · E
Wiki (c) | WikiWG | Templates | Proposed wiki changes | /Projects | Orphans | Oldest | CSS | JS V · T · E

This is a Wiki page dedicated to our Wiki explaining how to edit the wiki including this wiki page.

RECRUITING! Maintainer volunteers wanted, consider volunteering to become a maintainer. E

How to start editing the Wiki

[edit | edit source]
  1. Get a wiki account!
    • Request account from the top-right corner of any page. Note the bio will become an initial User_page (mw:Help:). It needs to include something like a minimum of 4-8 words, 40 characters to continue the process. Include enough for someone you met to recognize you from your interests.
      Image of request account link on page
      Request an Account, screenshot illustrating link, in upper-right corner of page.
      • Immediately notify a wiki maintainer/active user (in person, or via Discord in the #wiki channel, or Slack), so they can confirm your account. (We get dozens of spam requests per day, hundreds sit in the 1-month backlog, 1-month archive queues.)
      • When a wiki admin creates the account, our MediaWiki software will send you an email with a temporary password, from ...@noisebridge.net.
      • Congratulations, the hard part is done! Let the fun begin!
    • Note alternative and past processes include:
  2. Create a brief user page (Click the link at the top right with your username to the left of "Talk" that goes to a User:[Username] page.)
    Screenshot of upper-right corner of page in logged-in view, showing "[User]" and "Talk" links among others.
    User/User_talk screenshot, showing logged-in view, of page.
    1. Mention what activities you're interested in or working on.
    2. If you want to coordinate with others, provide pseudonymous contact info for yourself if you're comfortable sharing it.
    3. It does not have to have personally identifying info, pseudonyms or no contact info is fine if you want to remain private.
    4. Most people just put the handle or name they go by around the space and usernames for Slack/Discord/Discuss.
  3. Once you're confirmed you can create pages, update the Events page, & add yourself as a Maintainer for a Guild, Project, or Working Group.
  4. Volunteer to help maintain some part of Noisebridge by editing wiki pages.
  5. Join the Documentation working group to get more involved in improving Noisebridge docs including Wiki and Signage.

How to edit the Wiki pages

[edit | edit source]
  • You can edit most any page by clicking Edit.
  • You can figure out who else is recently maintaining a page by clicking 'View history.
  • Formatting page of mediawiki will tell you how to compose.
  • Some pages are protected so only logged in users or admins can edit them.
  • You should create an account and summarize your edits whenever possible to make collab with other editors work better.

How to help improve the Wiki

[edit | edit source]

Your best bet with wikis is always to reuse existing code in order to write better pages.

  • See this discussion on pruning and improving our wiki pages.
  • Integrate orphaned pages into the menu system by putting the appropriate { { guildmenutemplate } } at the top.
    • Edit the menu you added it under with a link to it, especially if it is currently relevant or in a historical menu category like Lore.
    • If it is historic, edit the main page in the submenu category with links to it under a Historic header at the bottom of the page instead of a menu link.
  • Mark outdated pages with the { { historic } }(no spaces between curly braces) template.
  • Mark parts of Noisebridge not fully constructed as { { construction } }
  • Create new categories and embed their tags in a template with a visible box like those.

How to make the menus

[edit | edit source]
  1. Most pages have menu header templates at the top which are nested hierarchically.
  2. Put a relevant menu header at the top like this: 
    {{projects}}
  3. Submit and click the link to the missing template if it doesn't exist to create it.
  4. Start a menu with a template code to the hierarchical menu above it if any.
  5. Follow that on a new line with the numbered box tag corresponding to the level of hierarchy in the menu for the correct rainbow color:
{{parentmenu}}
{{box2}} '''[[MenuTitle]]''' | [[Link1]] | [[Link2]] | [[:Template:MenuTitle|Edit]] 
{{boxend}}
  1. Separate menu links by | characters.
  2. Simplify menu link names using pipes like this: 
     [[Actual_Link|Clean looking link title]]
  • Use alphabetical link order if there isn't a specific flow that makes sense.
  1. Menu templates they should have an Edit link at the end linking to 
    [[:Template:Templatename|Edit]]

Wiki Content

[edit | edit source]

Wiki/Projects

Ontology covers the structural patterns of the wiki, in the work of wp:ontology, reaching for the simplest way to structure the shared knowledge here, to help participants keep the wiki up to date, through ease of navigation and understanding, and consistency in organization.

Quick Reference

[edit | edit source]

Important Sitewide Editable Resources

[edit | edit source]

Templates

[edit | edit source]

MediaWiki Templates support mw:transclusion of content from other pages into subject page, especially with arguments, anonymous, numbered, or named.

Transclusion can also be performed with a : prefix to the page name inside the Template invocation syntax {{:[template name]}} .

  • The syntax {{:Discord link}} embeds "https://discord.gg/GtpDdX5", from Discord link, which embeds the current discord link just once (so we can change it once, update the embedded text everywhere).


wp:Template:Navbox soon

[edit | edit source]

User:Mcint is working on installing extensions to support the familiar NavBoxes from wikipedia.


Categories

[edit | edit source]

Categories automatically recognize membership of any page containing a live link to the category, and MediaWiki shows categories in the footer (whether directly tagged, or included via template instantiations).

Using Categories:

  • To include a link to Category pages, for visibility & helping users navigate, use the Category template with : prefix:

Other variants of linking syntax and template invocation, include (transclude) category page content:

  • [[Category:5MoF]]
  • [[:Category:5MoF]] - linking to category syntax
  • {{Category:5MoF}}
  • {{:Category:5MoF}}

Categories page contents cannot be

CSS Styling

[edit | edit source]

HTML Colors

[edit | edit source]

We use a rainbow of pastel hues for boxes:

    1. FF9AA2,
  • Pastel backgrounds: #FFB7B2 #FFDAC1 #E2F0CB #B5EAD7 #C7CEEA.
  • Border colors: #FFFF63 #FEB144 #9EE09E #9EC1CF #CC99C9

Page Previews & Navigation Popup Gadget

[edit | edit source]

Since 2023, and verifiable at Special:Version we have mw:Page Previews enabled (specifically mwe:Popups & mwe:PageImages) extension installed, and enabled for logged out users and default user configuration (nominally, possibly rate limits or other anti-crawler settings might newly conflict).

Editors can also use wp:WP:Tools/Navigation_popups. If logged-in, you can enable it in your Preferences >> Gadgets tab, Special:Preferences#mw-prefsection-gadgets.

Conflicts with headerbox use

[edit | edit source]

Page Previews relies on at least 2 extensions for extracting text and images. The text extraction plugin (mw:Extension:TextExtracts), uses some carefully developer heuristics to part out irrelevant context at the start of a page, so that it can display a crisp summary to users hovering on mouseover.

Lessons learned

[edit | edit source]

In the interest of keeping the wiki editable and maintainable, it's helpful to use semantically appropriate template names for the level of page. {{introBox}} (or {{box/intro}}) for the elements, would help distinguish from Template:Home or multi-level, navigation headerbox use—which is pretty semantically different from page introduction.

There's a helpful pattern in {{t}}, that can, with judicious use of Show preview, help editors navigate to helpful & appropriate templates within the context of editing a single page—and without the need to memorize our wiki's whole library of particular key words & pages, nor toggle to other pages merely for help with local wiki syntax.

Wiki Server

[edit | edit source]

How the Wiki server is setup

[edit | edit source]


Possible additions to this wiki

[edit | edit source]

Wiki Contribution Domains

[edit | edit source]

Many places someone can meaningfully contribute to the wiki.

  • Content -- subject-matter content about the space -- this looks like: editing relevant wiki pages to improve a reader's understanding of the outside world
    • (Talk pages, discussion)
    • Content-structure -- templates, categories, guilds, maintainers -- helping track people who make updates, and the links that others navigate to build up pages.
    • (Preferences, scripts, & styling -- tested & developed in private views on your own account, before possibly sharing later. interwiki link configuration.
  • MediaWiki configuration -- (LocalSettings.php), Extensions, maintenance scripts, database, php-object & page caching
    • web server configuration, caching, currently Caddy -- (HAProxy could support better load shedding behavior)

Factors of similarity include:

  • Blast radius -- number of people: 1, many, all / defaults. User:[you]/custom.css, User:[you]/custom.js, ...
  • Blast radius -- number of pages: 1, many, all. Extensions or features that break, or make the wiki unavailable, increase load to unusability.

Tracking Projects

[edit | edit source]

Status

[edit | edit source]

Changelog

[edit | edit source]

A log of changes for coordination around the wiki (most-recent first). (More major changes have another home -- should have another home, linked here/ and back).

  • Added a favicon.ico a few days ago! Working on some issues with Claudebot crawler (mainly) taking down the site, from unsustainable load. --Mcint (talk) 01:33, 29 April 2024 (PDT)
  • Enabled timezones today, in wiki software. --Mcint (talk) 20:40, 10 December 2023 (PST)


This page is maintained by the Documentation Working Group. If technical writing is your thing, you should consider helping out by editing this page! | Document ALL The Things! YES, ALL THE THINGS | Edit

Subpages

[edit | edit source]

Special:PrefixIndex/Wiki/:

Special:PrefixIndex/Category:Wiki:

more loosely related, Special:PrefixIndex/Template:Wiki:

Retrieved from "https://main-wiki.extremist.software/index.php?title=Wiki&oldid=88064"