User:Mcint/WikiMaxxing: Difference between revisions

From Noisebridge
Jump to navigation Jump to search
(→‎Explore / Categorize (wip): add categories exts)
 
(32 intermediate revisions by the same user not shown)
Line 1: Line 1:


I'm on-boarding myself to more extensive wiki use. I've come across some features on Wikipedia that make it more a of delight to use and navigate. I'd like to document those features here (separated, or tagged by reader vs. editor benefitting), and encourage others to try them out.
I'm on-boarding myself to more extensive wiki use. I've come across some features on Wikipedia that make it more a of delight to use and navigate. I'd like to document those features here (separated, or tagged by reader vs. editor benefitting), and encourage others to try them out.
''It begins,'' I've created a category: [[:Category:Wiki/Project/Maxxing]], to track and proselytize approaches to wiki structuring I've found.


= Note well =
= Note well =
Wanted: links to mediawiki syntax, tables syntax inline, inline external image.
== Recommendations ==
== Recommendations ==
Hello other users of the wiki!
Hello other users of the wiki!
=== Preferences ===
==== Gadgets ====


I recommend, in [[Special:Preferences#mw-prefsection-gadgets]], the <q>Navigation popups</q> and <q>section link</q> (URL fragment) gadgets, to help you get around more easily and link more precisely for others.
I recommend, in [[Special:Preferences#mw-prefsection-gadgets]], the <q>Navigation popups</q> and <q>section link</q> (URL fragment) gadgets, to help you get around more easily and link more precisely for others.


If you're going to edit the wiki frequently, there's a "double-click to edit" preference as well, and an EditTop gadget for editing just the lead section, the introductory section before any headers.
If you're going to edit the wiki frequently, there's a "double-click to edit" preference as well, and an EditTop gadget for editing just the lead section, the introductory section rendered above the table of contents any headers, and appearing before the first <code>= header #1 =</code> in the [Help:WikiText wikitext].
 
=== Talk pages ===
AKA "Discussion" linked in the on-page header tabs. Use the "Add Topic" link that appears in the upper left to add a new topic, otherwise edit and reply within a section so other commenters, watching can get replies. IDK exactly how it works, not checking right now.
 
=== Markdown Conversion ===
https://pandoc.org/try/ convert <code>markdown</code> to <code>mediawiki</code>, or from one of the markdown variants.


== Differences ==
== Differences ==
Line 25: Line 37:


* In editing or browsing context: Toggle watchlist with <code>ctrl-opt-w</code>.
* In editing or browsing context: Toggle watchlist with <code>ctrl-opt-w</code>.
== Links ==
[[mw:Help:Links|Help:Links]]
=== Interwiki ===
[[Special:Interwiki]]. Allowing short links to other wikis, for example (mouseover or click) [[mw:]], [[wp:]], [[mw:Interwiki]], [[arxiv:2306.03423]], [[wp:Noisebridge]]


== Idioms ==
== Idioms ==
Line 35: Line 53:
|}
|}


=== Folding ===
=== Collapsible ===
* <i>Collapsable</i>: <code><nowiki>
Collapsing, or folding away, content can be done with these idioms.
* <i>Collapsible</i>: <code><nowiki>
<div class="mw-collapsible">...</div>
<div class="mw-collapsible">...</div>
</nowiki></code>
</nowiki></code>
Line 43: Line 62:
</nowiki></code>
</nowiki></code>
* Collapsed, subsection visible: <code><nowiki><div class="mw-collapsible mw-collapsed">[visible]<span class="mw-collapsible-content">[hidden]</span></div></nowiki></code>. (In my opinion, <code>div/span</code> > <code>div/div</code>. Flashes on load, but placeholds 1 line).
* Collapsed, subsection visible: <code><nowiki><div class="mw-collapsible mw-collapsed">[visible]<span class="mw-collapsible-content">[hidden]</span></div></nowiki></code>. (In my opinion, <code>div/span</code> > <code>div/div</code>. Flashes on load, but placeholds 1 line).
* ''Collapsed (default closed), with blockquote'': <code><nowiki>
<div class="mw-collapsible mw-collapsed">
<blockquote>
...
</blockquote>
</div><br>
</nowiki></code>
Example & sources, default collapsed:


<div class="mw-collapsible mw-collapsed">
<div class="mw-collapsible mw-collapsed">
Line 49: Line 78:
* [https://www.mediawiki.org/wiki/Manual:Collapsible_elements mw:Manual:Collapsible_elements] describes <q>Add the class <code>mw-collapsible</code> to any element (<code><nowiki><div></nowiki></code>, table, list, anything) to trigger it.</q>. Add <code>mw-collapsed</code> as an additional class to default it closed, hidden.  
* [https://www.mediawiki.org/wiki/Manual:Collapsible_elements mw:Manual:Collapsible_elements] describes <q>Add the class <code>mw-collapsible</code> to any element (<code><nowiki><div></nowiki></code>, table, list, anything) to trigger it.</q>. Add <code>mw-collapsed</code> as an additional class to default it closed, hidden.  
* [https://www.mediawiki.org/wiki/Manual:Collapsible_elements#With_specified_collapsible_part mw:Manual:Collapsible_elements#With_specified_collapsible_part]
* [https://www.mediawiki.org/wiki/Manual:Collapsible_elements#With_specified_collapsible_part mw:Manual:Collapsible_elements#With_specified_collapsible_part]
</span></div><br>


=== Quoting: Quote template & Blockquote html ===
=== Quoting: Quote template & Blockquote html ===
Line 54: Line 84:


=== nowiki (quoting) ===
=== nowiki (quoting) ===
<nowiki><nowiki>something in wiki or template syntax</nowiki></nowiki>
<code><nowiki><nowiki>something in [[Wiki|wiki]], [external-link title], or {{template}} syntax</nowiki></nowiki></code>
 
Particularly nice in combination with <code><nowiki><code></nowiki></code> tags for content ready to copy into an edit area: <code><nowiki><code><nowiki>something in wiki or template syntax< /nowiki></code></nowiki></code>
 
=== Useful Special: links ===
Link to page for the logged-in, viewing user, themself:
* [[Special:MyPage]]
* [[Special:MyTalk]]
* [[Special:Preferences]]


== Gadgets ==
== Gadgets ==
Line 90: Line 128:
** Confirm it works & nothing else is obviously broken.
** Confirm it works & nothing else is obviously broken.
* Congrats!
* Congrats!
</div></div>
== Video Embed ==
You can now embed video! See [[mw:Extension:EmbedVideo#Tags]] for how to invoke it, with <code><nowiki>{{templates...}}</nowiki></code> or custom tags <code><nowiki><youtube>https://www.youtube.com/watch?v=RYQY5-UepEk</youtube></nowiki></code>
<div class="mw-collapsible mw-collapsed">
In wikitext, use #ev / #evu / #evt templates: <code><nowiki>{{#evu:https://www.youtube.com/watch?v=RYQY5-UepEk}}</nowiki></code>
<div class="mw-collapsible-content">
{{#evu:https://www.youtube.com/watch?v=RYQY5-UepEk}}
</div></div>
</div></div>


= Features =
= Features =


= Wants =
=Wants=
* QR Code generated for each page, for printing / easy UX linking back to page
* Fix the favicon.
** https://www.mediawiki.org/wiki/Extension:QRLite
 
** Big list: https://www.mediawiki.org/wiki/QR_Codes
==Explore / Categorize (wip)==
** Shorturl would be nice <code>nburl.net/w/[wiki url]</code>? For better, simpler QR codes
* TOC - table of contents
** [[mw:extension:StickyTOC]]
** [[mw:extension:TocTree]]
* Categories
** [[mw:extension:CategoryTree]]
** [[mw:Category:Category_extensions]]
** [[mw:extension:Graphical_Category_Browser]]
 
==Feature==
 
 
===Graphical Category Browser===
* [[mw:Extension:Graphical_Category_Browser]] - using Graphviz to see the <s>tree</s> <s>dag</s> general graph of categories.
===References===
* References section - extract all URLs (or external links) into references footer section
* References section - extract all URLs (or external links) into references footer section
===Editors===
* Better editors
* Better editors
** Visual Editor (maybe via/after an upgrade. IDK if requires some mw version), as available at least on Wikipedia, Mediawiki.
** Visual Editor (maybe via/after an upgrade. IDK if requires some mw version), as available at least on Wikipedia, Mediawiki.
** Side by side editing, no scrolling to find edit textbox, nor preview (or live preview).
** Side by side editing, no scrolling to find edit textbox, nor preview (or live preview).
===Spam Handling===
* Better spam handling
* Better spam handling
** [[User:Mcint/Projects/Member_system]] will help greatly, once implemented.
** Deleted 50k spam users, which had not made edits.
** Deleted 50k spam users, which had not made edits.
** [[Special:ConfirmAccounts]]. Approving manually, ha (manually, poorly, 1743 in queue in ~ 2 weeks. 1 approved. ?# legitimate but unapproved.), as of 07:06, 4 June 2023 (UTC).
** [[Special:ConfirmAccounts]]. Approving manually, ha (manually, poorly, 1743 in queue in ~ 2 weeks. 1 approved. ?# legitimate but unapproved.), as of 07:06, 4 June 2023 (UTC).
Line 114: Line 177:
*** User list [[Special:ListUsers]].
*** User list [[Special:ListUsers]].
**** Format, spam identification.
**** Format, spam identification.
{|
{| class="wikitable" style="background-color: #fff;"
| <code>Username</code> (Many spam, not all, have FirstLast123, fit in elsewhere) || <code>( talk</code> (good, rare if present) || <code>contribs</code> (** major determinant of spam/ban-worthy. Navigation popups allow at-a-glance mouseover viewing || <code>block )</code> (is action-link) || <code>(groups,...)</code> if part of any, good sign of real/approved. confirmed/autoconfirmed just mean 3+ day old account, clicked emailed link - low signal groups. || <code>(Created [datetime])</code> :shrug:
| <code>Username</code> (Many spam, not all, have FirstLast123, fit in elsewhere) || <code>( talk</code> (good, rare if present) || <code>contribs</code> (** major determinant of spam/ban-worthy. Navigation popups allow at-a-glance mouseover viewing || <code>block )</code> (is action-link) || <code>(groups,...)</code> if part of any, good sign of real/approved. confirmed/autoconfirmed just mean 3+ day old account, clicked emailed link - low signal groups. || <code>(Created [datetime])</code> :shrug:
|}
|}
** Permissions, mediawiki internal, API below user group permissions?, [[Special:ListGrants]]
:* Permissions, mediawiki internal, API below user group permissions?, [[Special:ListGrants]]
 
===Activity indicators===
* Could try extension:
** [[mw:extension:HitCounters]]
** [[mw:extension:GoogleAnalyticsMetrics]]
** [[mw:extension:PageViewInfo]]
** [[mw:extension:UserPageViewTracker]]
** [[mw:extension:PagesVisited]] / with? [[mw:extension:UserSidebar]] and/or [[mw:extension:Dashboards]]
** or something self-hosted, embed with js. Would be good to anonymize.
 
===Authoritative DB - eg membership===
* In-wiki authoritative data: [[mw:extension:WikiDB]], would probably need.
** [[mw:Manual:Preventing_access]]
** [[mw:extension:Restrict_access_by_category_and_group]] (board, member, associate, contributor, #rack) groups?
** [[mw:extension:AccessControl]]
 
===External Images - Consider Allowing===
[[mw:Manual:$wgAllowExternalImages]], and possibly limiting it by: [[mw:Manual:$wgAllowExternalImagesFrom]], however it would be nice to update by an admin user via the wiki
 
== Extensions: to install ==
* Ease of editing, extensions to install.
** [[mw:Extension:VisualEditor]] (comes installed, need to configure).
** [[mw:Extension:UploadWizard]]
** [[mw:Extension:CharInsert]] ([https://github.com/wikimedia/mediawiki-extensions-CharInsert/archive/master.tar.gz master.tar.gz]) [https://github.com/wikimedia/mediawiki-extensions-CharInsert gh]. Use-case demo at [[mw:Extension:CharInsert#Styling]]
 
 
* [[mw:Extension:Diagrams]] would be good. It links too, to [[mw:Diagram_extensions]] <div>
<div class="mw-collapsible mw-collapsed">
<blockquote>
The Diagrams extension displays GraphViz, Mscgen, PlantUML, and Mermaid diagrams in a wiki. It can be configured to use a small web service to render the images.
 
It replaces the GraphViz, PlantUML, and Mermaid extensions in some ways, but does not (yet) support all features of all of them. The original reason for creating a new extension was to not store the rendered images as wiki files (as the GraphViz extension did), but it has changed to become a general diagramming extension.
</blockquote>
</div></div>
 
 
* Thinking about [[mw:Extension:Mermaid]] for mermaid js diagrams and flowcharts.
* Allowing some remote-wiki transclusion: [[mw:Manual:$wgEnableScaryTranscluding]]
 
=== Sources & Inspiration ===
*[[mw:Category:Extensions_used_on_Wikimedia]]
*[[mw:Category:Extensions_in_Wikimedia_version_control]]
 
== Make (or find) ==
* Gadget to toggle numbering of sections, on-page. Pref?
* ...
* (Gadget - easy-append todo list / TIL / notes / inbox. JS/AJAX on page, append / sections to personal page.)
* (Gadget to import gadgets? - prb perms issues MediaWiki: ns, Special: ns)
 
== Done! ==
== Done! ==
...at least a little
...at least a little
* Popup things
* Popup things
** [https://en.wikipedia.org/wiki/Wikipedia:Tools/Navigation_popups NavigationPopups] (and beyond the (Article:) namespace).
** (Done) Link-dense admin popups: [[wp:Wikipedia:Tools/Navigation_popups]] (and beyond the (Article:) namespace).
*** Extension:Popups
*** (Done) [[mw:Extension:Popups]]
****
** (Done) Reader-UX, clean preview popups: [[mw:Page Previews]] as implemented by [[mw:Extension:Page Previews]]
****
*** (Done) [[mw:Extension:Popups]]
** (Done) [https://www.mediawiki.org/wiki/Page_Previews Page Previews]
**** (Done) [[mw:Extension:TextExtracts]] (MediaWiki 1.37+ - installed older version.) I'll gladly help with a MediaWiki upgrade at some point.  Would be nice to build from nix.
*** (Done) [https://www.mediawiki.org/wiki/Extension:Popups Extension:Popups]
**** (Done) [[mw:Extension:PageImages]]
**** (Done) [https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:TextExtracts Extension:TextExtracts] (MediaWiki 1.37+ - installed older version.) I'll gladly help with a MediaWiki upgrade at some point.  Would be nice to build from nix.
** [[mw:Reference Tooltips]]
**** (Done) [https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:PageImages Extension:PageImages]
** [[wikimedia-meta:MoreMenu]]
** [https://www.mediawiki.org/wiki/Reference_Tooltips Reference Tooltips]
* QR Codes -18:17, 23 December 2023 (PST)
** [https://meta.wikimedia.org/wiki/MoreMenu MoreMenu]
** QR Code generated for each page, for printing / easy UX linking back to page
*** https://www.mediawiki.org/wiki/Extension:QRLite
*** Big list: https://www.mediawiki.org/wiki/QR_Codes
*** '''TODO''': Shorturl would be nice <code>nburl.net/w/[wiki url]</code>? For better, simpler QR codes

Latest revision as of 22:37, 16 March 2024

I'm on-boarding myself to more extensive wiki use. I've come across some features on Wikipedia that make it more a of delight to use and navigate. I'd like to document those features here (separated, or tagged by reader vs. editor benefitting), and encourage others to try them out.

It begins, I've created a category: Category:Wiki/Project/Maxxing, to track and proselytize approaches to wiki structuring I've found.

Note well[edit]

Wanted: links to mediawiki syntax, tables syntax inline, inline external image.

Recommendations[edit]

Hello other users of the wiki!

Preferences[edit]

Gadgets[edit]

I recommend, in Special:Preferences#mw-prefsection-gadgets, the Navigation popups and section link (URL fragment) gadgets, to help you get around more easily and link more precisely for others.

If you're going to edit the wiki frequently, there's a "double-click to edit" preference as well, and an EditTop gadget for editing just the lead section, the introductory section rendered above the table of contents any headers, and appearing before the first = header #1 = in the [Help:WikiText wikitext].

Talk pages[edit]

AKA "Discussion" linked in the on-page header tabs. Use the "Add Topic" link that appears in the upper left to add a new topic, otherwise edit and reply within a section so other commenters, watching can get replies. IDK exactly how it works, not checking right now.

Markdown Conversion[edit]

https://pandoc.org/try/ convert markdown to mediawiki, or from one of the markdown variants.

Differences[edit]

https://www.mediawiki.org/wiki/Differences_between_Wikipedia,_Wikimedia,_MediaWiki,_and_wiki

Preferences[edit]

  • Auto-number sections
  • (TODO: links to section head from self, not just from page's table of contents).

Trying out[edit]

Shortcuts[edit]

  • When editing, with editor open: ctrl-opt-p - preview, ctrl-opt-s - save, (ctrl-opt-v - show changes/diff)
  • When browsing, go to your own userpage: Special:Mypage with ctrl-opt-..
  • In editing or browsing context: Toggle watchlist with ctrl-opt-w.

Links[edit]

Help:Links

Interwiki[edit]

Special:Interwiki. Allowing short links to other wikis, for example (mouseover or click) mw:, wp:, mw:Interwiki, arxiv:2306.03423, wp:Noisebridge

Idioms[edit]

Code - not quite quoting[edit]

  • For code, literal or copyable text, or config files, useful variants include:
<tt> <code>
<pre>

Collapsible[edit]

Collapsing, or folding away, content can be done with these idioms.

  • Collapsible: <div class="mw-collapsible">...</div>
  • Collapsed, i.e. default closed: <div class="mw-collapsible mw-collapsed">...</div>
  • Collapsed, subsection visible: <div class="mw-collapsible mw-collapsed">[visible]<span class="mw-collapsible-content">[hidden]</span></div>. (In my opinion, div/span > div/div. Flashes on load, but placeholds 1 line).
  • Collapsed (default closed), with blockquote: <div class="mw-collapsible mw-collapsed"> <blockquote> ... </blockquote> </div><br>

Example & sources, default collapsed:

Linking to sources:


Quoting: Quote template & Blockquote html[edit]

mw:Template:Quote

nowiki (quoting)[edit]

<nowiki>something in [[Wiki|wiki]], [external-link title], or {{template}} syntax</nowiki>

Particularly nice in combination with <code> tags for content ready to copy into an edit area: <code><nowiki>something in wiki or template syntax< /nowiki></code>

Useful Special: links[edit]

Link to page for the logged-in, viewing user, themself:

Gadgets[edit]

Pages for testing, viewing, & changing your experience:

Try yourself[edit]

You can add your own, via your Special:Mypage/common.js (or Special:Mypage/global.js). JS was enabled for the wiki per MW Manual with $wgAllowUserJs = true;

Enable for all[edit]

...

Relevant links, open these first. Note Namespaces / Prefixes and Gadget(s). In order least-to-most sensitive:

Constituents of Gadget-vector-headanchor, as an example:

Instructions:

  • Find Gadget worth trying on another wiki. MediaWiki & Wikipedia have numerous and well-used samples.
  • (Try it via the person route above User:Mcint/WikiMaxxing#Try_yourself. If you like it, and think it should be shared, talk it over in Slack#wiki or Discord# ? metaguild?, and continue.)
  • Open Special:Gadgets
    • Copy definition string from other wiki's Special:Gadgets into this one, Special:Gadgets.
    • Follow the new linked definition files and create the pages, copying over the contents.
    • Check all are loaded.
  • Open your Special:Preferences#mw-prefsection-gadgets. Enable. Hard refresh an appropriate page to test it.
    • Confirm it works & nothing else is obviously broken.
  • Congrats!

Video Embed[edit]

You can now embed video! See mw:Extension:EmbedVideo#Tags for how to invoke it, with {{templates...}} or custom tags <youtube>https://www.youtube.com/watch?v=RYQY5-UepEk</youtube>

In wikitext, use #ev / #evu / #evt templates: {{#evu:https://www.youtube.com/watch?v=RYQY5-UepEk}}

Features[edit]

Wants[edit]

  • Fix the favicon.

Explore / Categorize (wip)[edit]

Feature[edit]

Graphical Category Browser[edit]

References[edit]

  • References section - extract all URLs (or external links) into references footer section

Editors[edit]

  • Better editors
    • Visual Editor (maybe via/after an upgrade. IDK if requires some mw version), as available at least on Wikipedia, Mediawiki.
    • Side by side editing, no scrolling to find edit textbox, nor preview (or live preview).

Spam Handling[edit]

Username (Many spam, not all, have FirstLast123, fit in elsewhere) ( talk (good, rare if present) contribs (** major determinant of spam/ban-worthy. Navigation popups allow at-a-glance mouseover viewing block ) (is action-link) (groups,...) if part of any, good sign of real/approved. confirmed/autoconfirmed just mean 3+ day old account, clicked emailed link - low signal groups. (Created [datetime]) :shrug:

Activity indicators[edit]

Authoritative DB - eg membership[edit]

External Images - Consider Allowing[edit]

mw:Manual:$wgAllowExternalImages, and possibly limiting it by: mw:Manual:$wgAllowExternalImagesFrom, however it would be nice to update by an admin user via the wiki

Extensions: to install[edit]


The Diagrams extension displays GraphViz, Mscgen, PlantUML, and Mermaid diagrams in a wiki. It can be configured to use a small web service to render the images.

It replaces the GraphViz, PlantUML, and Mermaid extensions in some ways, but does not (yet) support all features of all of them. The original reason for creating a new extension was to not store the rendered images as wiki files (as the GraphViz extension did), but it has changed to become a general diagramming extension.


Sources & Inspiration[edit]

Make (or find)[edit]

  • Gadget to toggle numbering of sections, on-page. Pref?
  • ...
  • (Gadget - easy-append todo list / TIL / notes / inbox. JS/AJAX on page, append / sections to personal page.)
  • (Gadget to import gadgets? - prb perms issues MediaWiki: ns, Special: ns)

Done![edit]

...at least a little