Help:Contribute: Difference between revisions

From stencil.wiki
No edit summary
No edit summary
 
(34 intermediate revisions by the same user not shown)
Line 1: Line 1:
Thanks for helping build out the wiki! There's always lots to be done (especially after the <u>migration</u> from the old site)—this page provides an overview of some of the main tasks we need help with.
Thanks for helping build out the wiki! There's always lots to be done (especially after the <u>migration</u> from the old site)—this page provides an overview of some of the main tasks we need help with.


== Getting started ==
{{mbox|title=Getting started|text=First things first, check out [[Help:Quickstart]] to setup an account and learn more about this wiki and how to edit it.|icon=seedling|color_bar={{wiki color|Kelly Green}}}}
{{mbox|title=Update your place in the atlas|text=<p>Editing ''your own place page'' is a great way to get a feel for the system. Follow the instructions on [[Help:Places]] to setup or edit the page for your studio/printshop.</p><p>''Detailed instructions are listed in the "Walkthrough" section.''</p>|icon=location-dot|color_bar={{wiki color|Sunflower}}}}


Here's some quick steps to get setup and oriented as an editor!
== Ongoing projects ==


# If you have not already, you can use [[Special:CreateAccount]] to create an account (all you need is an email address and a password) and start editing.
=== Validating imported places ===
# Some useful context to check out:
#* The "Understanding the wiki way" section of [https://www.mediawiki.org/wiki/Best_practices_for_using_MediaWiki#Understanding_the_wiki_way Best practices for using MediaWiki] to learn about the ''ethos'' of a wiki.
#* The [[Stencil:Styleguide]] for guidelines on writing for and editing this wiki.
#* If you're interested in some background, this post: [https://robertbaxter.substack.com/p/red-link-citation-needed robertbaxter.substack.com/p/red-link-citation-needed] from [[User:Robertbaxter]] on how this wiki came to be.
#* The '''#stencil-wiki''' channel in the @risography discord server (contact Robert or George for a link if you are not a member).
# An introduction to editing tools:
#* To learn about ''wikitext'' (the markup language used for wiki editing) read the [https://www.mediawiki.org/wiki/Cheatsheet MediaWiki cheatsheet] (more detailed information can be found in [https://www.mediawiki.org/wiki/Help:Formatting Help:Formatting] (also from MediaWiki). Whenever you use the "Edit source" button it will take you to a wikitext editor (with limited WYSIWYG tools along the top bar).
#* If you're editing the body of an article, it might be easier to use the ''Visual Editor''—this is what you get when using the "Edit" button. It's a much more straightforward in-place editor, but not great at handling templates or fine-tuning layout.
#* And for [[:Category:Places]], [[:Category:Events]], [[:Category:Inks]], [[:Category:Duplicator series]], and [[:Category:Tutorials]], you're probably doing most of your editing with a ''Page Form'', using the "Edit with form" button. This is a pretty straightforward (though ugly) HTML form interface, with the body of the article in one big textbox at the end.
# Before you get editing pages, there's some important rules to know!
{{Warning|<ul><li>Remember not to include personal or identifiable information on the wiki for anyone but yourself (if you choose to share it)—this means no addresses, no emails, etc.</li>
<li>Please <u>don't submit any copyrighted files, images, or text without permission</u>!</li>
<li>Use <code><nowiki><ref></ref></nowiki></code> tags to reference outside sources for articles, then include <code><nowiki>{{References}}</nowiki></code> at the end of the page to display them!</li></ul>}}


And that's it, welcome to the wiki!
With the relaunch of the wiki, one of the big goals was to update the [[atlas]], filtering out places which are no longer active and generally updating all pages. Of the '''{{#ask:[[Category:Places]]|format=count}} places''' in the wiki, '''{{#ask:[[Category:Imported places]]|format=count}}''' have not been edited since they were imported (listed in [[:Category:Imported places]]). We need to go through all of these pages and ''validate'' them. Until they are validated, <u>they will not appear on the map or show up in most place listings.</u>.


== First edits ==
* Instructions for validation are here: [[Help:Validating a place]].
* Some regional working pages are available here: [[:Category:Regional working pages]].


Editing ''your own place page'' is a great way to get a feel for the system.
<div style="text-align:center; margin-top: 2em; margin-bottom: -1em; padding-bottom: em;">'''Import countdown'''</div>
{{mbox|text=<table><tr><td style="min-width: 25%; padding-right: 1.5em; vertical-align: middle; text-align: center; border-right: 1px solid {{wiki color|Light Gray}}"><p style="font-size: 2em; line-height: 1em; margin: 0em;">{{#ask:[[Category:Imported places]]|format=count}}</p></td><td style="padding-left: 1.5em;"><p>Random places to validate: {{#ask:[[Category:Imported places]]|limit=5|order=rand|searchlabel=}}</p></td></tr></table>|max_width=50%|border=1px solid {{wiki color|Light Gray}}}}


If you manage a riso somewhere, check and see if your space already has a page on the wiki! Use the search bar at the the top of the page to search for your press/printshop/studio name.
=== Editing & rewriting resources ===
# If the page already exists, click the "Edit with form" button at the top of the page.
# To create a new place page you'll want to use [[Form:Place]], typing in the name of your studio, and then clicking "Create or edit."


Once you're in the form for the page, you can change the details of the place, or use the big free text box at the end of the page to edit the article content.
The original wiki had a number of tutorials, files, and other resources written by users. These have more or less been archived on the [https://archive.org/ Wayback Machine]. They couldn't be automatically imported because they each have fairly complex and unique formats. We are manually rewriting these into the voice of the new wiki—updating their content, merging similar resources, and adding references along the way.


# Check and update your __website__ link, inventory of __inks__, list of __machines__, etc. You can also add __location__ information and __services__.
* Articles that need rewriting are here: [[:Category:Pages awaiting migration]]
# If you add __coordinates__, your place will show up on the [[Atlas|atlas]]!
* Partially drafted or incomplete articles are here: [[:Category:Draft pages]]
# For the __article__, try adding some text explaining your studio!
* All resource pages are here: [[:Category:Resources]]
#* See that <code><nowiki>{{Inventory}}</nowiki></code> text in there? That invokes the [[Template:Inventory]] component, which displays a visual list of the inks and machines you selected.
* A breakdown of all pages for migration is here: [[Stencil:Roadmap#Resources]]
#* You can add a citation to some other page (maybe the about page on your site) if you want, by including the link in <code><nowiki><ref></ref></nowiki></code> tags (for example: <code><nowiki><ref>https://perfectly-acceptable.com/print/</ref></nowiki></code>). Then at the end of the free text/article box, add <code><nowiki>{{References}}</nowiki></code>
#* Generally for place pages, there's some kind of introduction, then people might have subheadings to talk about different topics (e.g. <code><nowiki>== History ==</nowiki></code>), then they have the <code><nowiki>{{Inventory}}</nowiki></code> template and the <code><nowiki>{{References}}</nowiki></code> template (if there were citations on the page).
# Once you're done editing, click "Save changes" and your new/updated page will be saved to the wiki!
#* You can optionally provide a little descriptions of the edits you made in the "Summary" box before saving—this will be saved along with the record of your edits, and can be useful when looking through the history of a page (but is not strictly necessary).
#* If you have "Watch this page" selected you'll get a little notification (when logged into the wiki) when someone else edits this page.
# If you want to check out the other ways of editing a page, try the "Edit" button (for the Visual Editor) or "Edit source" button (for the wikitext editor).


For more information on places, please see [[Help:Places]]. Also feel free to use the [[Atlas|atlas]] to look at other place pages for ideas! (Though many are also mostly blank pages, waiting to be updated.)
=== Adding upcoming events ===
 
The [[Events]] page lists out all the upcoming events that risographers are tabling at, organizing, and participating in—but it only reflects the events which are contributed to it! If you know of any upcoming events in your region, please add them to the list!
 
== Structural development ==
 
The above is editorial work, but there's a lot of architectural stuff we're working on for the wiki too (much more slowly). A list of the heavier work planned for the wiki can be found on the [[Stencil:Roadmap]]. This sort of work will involve a lot more knowledge of wikitext, how to use and edit templates, and potentially some Lua scripting.
 
''Right now the development team for the wiki is [[User:Robertbaxter]] and [[User:IssuePress]]—but we're welcome to other contributors!''

Latest revision as of 14:38, 7 October 2025

Thanks for helping build out the wiki! There's always lots to be done (especially after the migration from the old site)—this page provides an overview of some of the main tasks we need help with.

Getting started
First things first, check out Help:Quickstart to setup an account and learn more about this wiki and how to edit it.
Update your place in the atlas

Editing your own place page is a great way to get a feel for the system. Follow the instructions on Help:Places to setup or edit the page for your studio/printshop.

Detailed instructions are listed in the "Walkthrough" section.

Ongoing projects

Validating imported places

With the relaunch of the wiki, one of the big goals was to update the atlas, filtering out places which are no longer active and generally updating all pages. Of the 1090 places in the wiki, 750 have not been edited since they were imported (listed in Category:Imported places). We need to go through all of these pages and validate them. Until they are validated, they will not appear on the map or show up in most place listings..

Import countdown

Editing & rewriting resources

The original wiki had a number of tutorials, files, and other resources written by users. These have more or less been archived on the Wayback Machine. They couldn't be automatically imported because they each have fairly complex and unique formats. We are manually rewriting these into the voice of the new wiki—updating their content, merging similar resources, and adding references along the way.

Adding upcoming events

The Events page lists out all the upcoming events that risographers are tabling at, organizing, and participating in—but it only reflects the events which are contributed to it! If you know of any upcoming events in your region, please add them to the list!

Structural development

The above is editorial work, but there's a lot of architectural stuff we're working on for the wiki too (much more slowly). A list of the heavier work planned for the wiki can be found on the Stencil:Roadmap. This sort of work will involve a lot more knowledge of wikitext, how to use and edit templates, and potentially some Lua scripting.

Right now the development team for the wiki is User:Robertbaxter and User:IssuePress—but we're welcome to other contributors!