Wiki: Difference between revisions

From Noisebridge
Jump to navigation Jump to search
Mcint (talk | contribs)
top: add myself as maintainer, content + server
Mcint (talk | contribs)
Add sub-page for projects, add Template & Category tutorials & explorations, link to User:Mcint/WikiMaxxing overview
Line 51: Line 51:


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


== Important Editing Links==
== Important Editing Links==
* [[MediaWiki:Common.css]]
*[[MediaWiki:Common.css]]
*[[MediaWiki:Sidebar]]
*[[MediaWiki:Sidebar]]
===Templates===
MediaWiki [[mw:Help:Templates|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 <code>:</code> prefix to the page name inside the [[mw:Help:Template|Template]] invocation syntax <code><nowiki>{{:[template name]}} </nowiki></code>.
* The syntax <code><nowiki>{{:Discord link}}</nowiki></code> embeds "{{:Discord link}}", which embeds the current discord link just once (so we can change it once, update the embedded text everywhere).
*[https://www.noisebridge.net/wiki/Special:AllPages?from=&to=&namespace=10 All templates]
*[[:Template:Boxstart|boxstart template]]
*[[:Template:Boxstart|boxstart template]]
*[[:Template:Box|box template]]
*[[:Template:Box|box template]]
Line 69: Line 79:
*[[:Template:cursorboxend|cursorboxend template]] for closing locations with blinking cursor.
*[[:Template:cursorboxend|cursorboxend template]] for closing locations with blinking cursor.


===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.


Using Categories:
* 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:5MoF]]</nowiki></code> produces [[:Category:5MoF]] (case-sensitive)
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> - linking to category syntax
* <code><nowiki>{{Category:5MoF}}</nowiki></code>
* <code><nowiki>{{:Category:5MoF}}</nowiki></code>
Categories page contents cannot be
*[https://www.noisebridge.net/wiki/Special:AllPages?from=&to=&namespace=14 All categories]


== CSS Styling ==
== CSS Styling ==
Line 87: Line 113:
* [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.
* Define how to delete users with no contributions.
* <del>Define how to delete users with no contributions.</del> Done, with mediawiki maintenance scripts.
 
* [[User:Mcint/WikiMaxxing]]

Revision as of 02:45, 7 December 2023

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

  1. Create an account.
  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.
    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. Volunteer to help maintain some part of Noisebridge by editing wiki pages.
  4. 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

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


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.

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

HTML Colors

We use a rainbow of pastel hues for boxes:

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

Wiki Server

How the Wiki server is setup


Possible additions to this wiki