Wiki

This is a Wiki page dedicated to our Wiki explaining how to edit the wiki including this wiki page. CONTENT MAINTAINERS: User:Mcint, User:Lxpk, User:Hungry bogart, more needed SERVER MAINTAINERS: User:Mcint, #rack@Slack CHANNELS: #wiki on Discord (and on Slack) EVENTS: Work on Wiki before/during/after every Tuesday Meetings & To-do-ocracy Thursday. Wiki_Wednesday workshop could be rebooted! RECRUITING! Maintainer volunteers wanted, consider volunteering to become a maintainer. E

How to start editing the Wiki

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.
       • 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 confirmed permission. On each User page, the sidebar footer Tools section, has a link to Change user groups. (This link also resides in the 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 Special:ListUsers -- sort by created time, descending.
     • Congratulations, the hard part is done! Let the fun begin!
   • Note alternative and past processes include:
     • Create an account (default) now redirects to Special:RequestAccount.
     • Seek an Invitation to Signup from an existing wiki user, by giving them your email (most can) in-person, by email, or via a chat app,
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

• 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

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

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

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

Important Sitewide Editable Resources

• MediaWiki:Common.css
• MediaWiki:Sidebar

Templates

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 "Discord link", from Discord link, which embeds the current discord link just once (so we can change it once, update the embedded text everywhere).

• All templates
• boxstart template
• boxes template| is new self-descriptive root of hierarchy, for color reference, and self-documenting on headerbox templates
• box template
• box1 template
• box2 template
• box3 template
• box4 template
• box5 template

• boxend template for closing any box.
• headerbox template
• blackbox template for locations.
• cursorboxend template for closing locations with blinking cursor.

wp:Template:Navbox soon

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

Categories

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:
  • [[:Category:ActiveUsers]] produces Category:ActiveUsers,
  • [[:Category:5MoF]] produces Category:5MoF (case-sensitive)

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

• All categories

CSS Styling

HTML Colors

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

File:Rainbowcolorcodes.jpg

Wiki Server

How the Wiki server is setup

• Special:Version tells you all about how the site is setup, including installed extensions.

Possible additions to this wiki

• Oauth will allow us to integrate login from this wiki to our Discourse instance using wikimedia-auth plugin and to https://projects.noisebridge.info with this.
• StopForumSpam extension for helping limit new user registration spam.
• Define how to delete users with no contributions. Done, with mediawiki maintenance scripts.

• User:Mcint/WikiMaxxing

Tracking Projects

Status

• wp:Template:Navbox: needs a bunch of extensions. Some installed, in-progress. --Mcint (talk) 20:40, 10 December 2023 (PST)

Changelog

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 mw:Extension:InputBox to try out page creation from on-page input boxes. --Mcint (talk) --~~~~ 17:19, 21 January 2025 (PST)

• Enabled Extension:MultimediaViewer to support better image viewing & mw:Extension:BetaFeatures to support phased roll-out, or trying, of new extension features --Mcint (talk) 16:45, 12 May 2024 (PDT)

• Enabled Extension:VisualEditor, with WYSIWYG editing & an on-page image uploader. Also added Extension:CharInsert to insert helpful bits of syntax when editing wikitext. --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. --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 Wiki/big Subpages Special:PrefixIndex/Wiki/: Wiki/Extensions Wiki/Extensions/Categorytree Wiki/Learn Wiki/Ontology Wiki/Projects Wiki/Talk Wiki/Transclusion Special:PrefixIndex/Category:Wiki: more loosely related, Special:PrefixIndex/Template:Wiki: Wiki Wikipages Wikiwg/badges