Help: Difference between revisions

From wiki.occupyboston.org
Jump to navigation Jump to search
No edit summary
(redirect to help pages because)
 
(63 intermediate revisions by 3 users not shown)
Line 1: Line 1:
===general notes on organization===
#REDIRECT [[Help:Contents]]
:This wiki collects information and ideas that can help to grow the Occupy Boston movement. As authors we want to create compelling and interesting content. To a large extent, the wiki organizes itself as we link to each others ideas.


====wiki philosophy and etiquette====
<!-- A NOTE ON THIS REDIRECT: It has been found that the full help contents as written on mediawiki are much more efficient, and so they have been manually copied for the benefit of occupy boston. Cheers! ~~~~ -->
The defining thing with wikis is summarized in the proviso on every page
<blockquote style="border: 0px solid blue; font: 10px/12px Times, serif; font-style: italic; padding: 0em;">If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here. </blockquote>
Wikipedia has proven that participatory democratic content creation can work on a worldwide basis. As a member of this wiki you can become a content creator. Before you modify a page consider that someone else probably put in the page what they thought was best. Before you modify a page check in with the prior editor/creator by:
*go to discussion tab for the page and create a topic that discusses your proposed changes. Sign your comments with <nowiki>~~~~</nowiki>  
*check the page history to find who authored the page. Click on their username and when you get to their page email them by clicking on the menu item in the lower left column.
*as an author try to be open to change and collaboration. No one really owns a page or the ideas on a page.


====personal webspaces====
Welcome to the Occupy Boston wiki Help page. This page is dedicated to helping users understand their 'wiki rights' and use of the basic wiki tools.
:This wiki (Mediawiki(same software that runs Wikipedia) allows the creation of webspaces for each user and working group.


:As a general guideline, we suggest that you put your developing work, personal manifestos and collected interesting stuff in your user webspace. Consider the main wiki to be a public face of Occupy Boston and as such it should draw in readers to the movement with concise well edited content arrived at by an attempt at concensus.  
To become a user, '''create an account''' with the link in the upper right corner. Once logged in, please go to your user-page (click the link at the very top of the page) and ''add your contact information'' so that others will be able to collaborate with you. You can also verify your email to get updates. Explore your preferences for more options.  


====[[Working Groups]] - pages a workspaces====
Don't just watch - '''all users have the rights to read, discuss, edit, move (rename), and create new pages.''' Use the tabs at the top of the page to navigate 'within' pages. The ''Page'' and ''Discussion'' tabs distinguish collaborative spaces. ''Edit'', ''View history'', ''Move'', and ''Watch'' are the basic functions with which every user should be familiar. This page covers only the most basic tools provided in the wiki software.
:[[Working Groups]] have a public face and can have a group workspace. To have a workspace for the group create a working group account by [http://wiki.occupyboston.org/index.php?title=Special:UserLogin&type=signup creating a new user account] following the convention User:WG-groupname and create internal working group content as subpages of User:WG-groupname ([[#creating a subdirectory in your webspace|see below]])


====referencing other documents====
:''[[User:OneKarma]] welcomes all wiki- and communication-related inquiries. Email: onekarma.ob@gmail.com''
=====to link to pages on the wiki=====
:''Read [[User:Renjender|Renjender's]] '''[[Help:Editing|5 Second Wiki Lesson]]'''.''
:Put a link using double brackets and the name at the top of the page like this <nowiki>[[page name]]</nowiki>
:''For precise formatting help, view [http://www.mediawiki.org/wiki/Help:Formatting MediaWiki's help page]''
=====to link to pages on other sites=====
:You can create a link to content off site by creating a link with single brackets like this <nowiki>[http://urlofpage.com/page]</nowiki>
====posting a document hosted only on your personal computer====
:Click on 'Upload file' on the left menu bar.
====Adding Notes====
*Notes about format and language often belong right on the page.
*Notes should be in brackets and announced. [Note: This is an example of a note.]


In order to contribute you need to...
==Basics==
===to create a login account on occupyboston wiki===
'''The most difficult part of contributing is writing something that is agreeable to an open group.''' This wiki has nearly 130 active contributors (as of 29 Nov 2011). There have been various 'message statement' groups that have failed because a strong statement is hard to agree upon in diverse groups. The best way to work is to just ''write''. After you write/create something (whether a personal statement or an encyclopedic page), you can post your work in the appropriate place(s) on the wiki. If the appropriate topic page for your work doesn't seem to exist, create it! Place links on existing pages to your new page. (Use the 'Page' tab for solid facts/agreements, and try to keep the 'Discussion' on its own tab - ''see [[#Editing|editing instructions]] below for details''.)
#click-on the '''''login/create_account button''''' in the upper right corner
#click on "Create an Account"
#Put in username, password and email


===Creating content (basic)===
===Learn by Observing and Doing===
:Creating your own content is easy. You can edit any page by clicking on '''Edit this page (top right)''' . You can comment on any page by clicking on '''Discussion''' tab. After you add your content sign it by clicking on the '''signature button''' (the second button from the right on top or enter  <nowiki>~~~</nowiki>) then '''save page (bottom)'''.[[User:Mcktimo|Mcktimo]] 00:47, 23 October 2011 (EDT)
The best way to learn how to contribute to the wiki is to see what is already here and to determine the similar aspects you would like to see. Use the 'Edit' function on any page to see the formatting for that page. (It is recommended to use the [[#'Rich' vs. 'Wiki' Text Editors|'WikiText' instead of the 'RichText' Editor]], as this offers more precise control.) To switch editors, click the link above the top left of the editing box, to 'Show (other) Editor'.  


====creating content in your webspace====
Every page on the wiki should '''clearly represent a specific idea'''. You can clarify the intent of a page (and thereby direct its future use) by adding a precise description of its function, which will strongly promote the healthy growth of the wiki.
:1st make sure you are logged in.
:To write in your page click on your username at the top of the page. Click on edit this page. Just start writing at the top of the page. Your prior writing will be pushed down and your most current writing will always be at the top of the page. Start a new paragraph by skipping a line. Don't indent(if you want a paragraph to be indented put a : in front of it). Hit '''save page''' (at the bottom of the page) to save your work. Do it often!


{{:creating a user: subpage}}
'''Page titles''' should be short and sweet, and should contain relevant hierarchies if possible. For example, a draft proposal from the Safety WG should be entitled ''Safety/Proposal X''. This creates navigable sub-spaces for our mass of information by automating 'return' links, but only when both the sub-page and the host page exist. For example, if both pages ''WG'' and ''WG/Proposal X'' exist, a link to ''WG'' will automatically appear at the top of the ''WG/Proposal X'' page.


====making a table of contents and titles/heading====
* '''Etiquette''' should require no more mention than this.
:To organize your work give each piece of writing its own title. To create a title, type, on its own line:<br>
* '''Leave a signature''' to help people collaborate with you. The wiki will automatically change four tildes (<nowiki>~~~~</nowiki>) into a link to your user-page and a time-stamp when you 'Save' the page. Add solid contact information to your user-page for best results.
<nowiki>==your title here==</nowiki>
* '''[[#Links|Internal links]]''' are like nerve endings - they pick up and direct information within the whole. Consider the many paths by which collaborators and visitors might want to explore the wiki, and try to create a network with many 'nerve endings'. Information should be linked on any and all relevant pages.
=====making <nowiki>__NOTOC__</nowiki>=====
:Put that at the top of your page if you don't want to show a table of contents.


====you cannot erase====
===Search===
:You can always get back to a prior version of the page by clicking on it in '''view history'''(top right)
There is a search bar at the top right of every page. It works!


====taking notes, creating lists====
===Mailing List Help===
To organize your notes you can use bullet lists and numbered lists. To create a bullet list like this
'''For admins''' of working group mailing lists, OBIT has designed a [[List Help]] page (with images) to guide you through the mailing list configuration.
*first point
*another point
*etc
just start a line with an *
<br>For a numbered list
#first
#second
#third
just start each line with a # symbol (don't skip lines)


====writing a poem====
==Methodology and Content Rights==
:If you don't skip a line the text on the next line always 'wraps' to follow the text on the line above. Sometimes that's not cool,like for a poem. To avoid word wrap you can use <nowiki><pre> </pre></nowiki>
'''''Anyone can become a content creator, but no one is ever a content 'owner.'''''' See the cautionary note on every Editing page:
<blockquote style="border: 0px solid blue; font: 14px Times, serif; font-style: italic; padding: 0em;">If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here. </blockquote>
[http://www.wikipedia.org/ Wikipedia] is standing proof that crowd-sourced content creation and management can be effective on a global web-space. 


===Etiquette===
Before you modify a page, please consider the intent of the existing text. There are many authors, and everyone is making their best contributions.
* You can 'check-in' with prior editors by using the Discussion and History tabs at the top of every page.
* If you want others to collaborate regarding your notes, '''don't forget to sign your comments''' by inserting four tildes (like this: <nowiki>~~~~</nowiki>). The wiki will automatically insert a link to your user-page next to a time-stamp for the comment.
* You can email other users by going to their user-page and clicking the link that appears in the bottom of the side-bar. This will send an email to the address registered with that username.


:Another way to prevent word wrap is to just skip a line.
===Public vs Personal Space===
As a general guideline, please consider the main structure to be a public face of Occupy Boston. It should have the appearance of professionalism, inviting readers with clarity, brevity, and relevancy.


==== using the graphical editor====
Every user has their own dedicated userpage. Edit your userpage to add contact information, personal statements, and to organize projects you may be working on. See [[User:OneKarma]] for a well-developed example. It is suggested that users keep their contact information, personal statements, projects, and reference collections in their own user web-space. You can also create sub-pages in your user-space with the following naming convention: ''User:YourName/Page Name''.
:A graphical editor is a little slower. It hides the guts of the wiki markup language.


==== moving stuff from Word? ====
==Tools==
:Write in Word. Single spaced, do not indent first lines, skip lines between paragraphs. Copy and paste into the wiki when you are done.
Navigating the wiki should be intuitive. If it is not, please let us know! [[User:OneKarma]] welcomes all wiki-related inquiries.


There are many other cool things you can try that create nice pages...
The side-bar contains the main navigation links, and you should be able to reach every page on the wiki by following links on various pages. Most of the wiki is contained on the Working Groups pages. Working Groups are ever-growing, as is the list of working groups itself! Don't be shy; add your voice to any and all conversations that interest you.


==other help==
===Page, Discussion, and History===
===[http://meta.wikimedia.org/wiki/Help:Editing#Editing_Basics Editing and Formatting]===
The 'Page' tab (top left) is meant to be a public face regarding the topic/title of the page. Please try to keep these pages organized with the most important information, because many people will see only this part of the page.


http://meta.wikimedia.org/wiki/Help:Contents
The 'Discussion' tab (top left) is meant to be 'conversational' in a way.  


A lot of HTML will work in the wiki. Try [http://www.tedmontgomery.com/tutorial/index.html editing HTML]
There is a 'history' of every page that is automatically archived by the wiki software, so there is never a need to worry about 'losing' information. Use the 'View history' tab on the top right to compare versions of a page.  


===[[SandBox]]===
===Signature===
:To try out formattng and editing features use this space
'''Please leave a signature''' when you add comments to discussions. Insert four tildes, like this: <nowiki>~~~~</nowiki>, for the wiki to automatically insert this: [[User:OneKarma|OneKarma]] 15:14, 21 November 2011 (EST). Other users may want to collaborate regarding the notes you have added, so your signature will let them know how to find you.
===[http://www.mediawiki.org/wiki/Help:Images help:images]===


===[http://meta.wikimedia.org/wiki/Help:Magic_words Magic Words]===
===New Pages===
If you want to be able to do some thing like Wikipedia does we may need to add an extension. Find somebody from the OBIT(tech) working group and we'll try to get it set up.
All users have the right to create new pages. Creating a new page is as easy as visiting the page you want with your web browser, and clicking 'Create' in the top right. This page was created by typing "wiki.occupyboston.org/wiki/Help" into the url bar, and then clicking 'Create' ''(note that all pages begin with "wiki.occupyboston.org/wiki/" by default)''. The title of the page is exactly the same as what follows ""wiki.occupyboston.org/wiki/", so remember to ''Capitalize'' where appropriate.


=== Checking occupyboston.org email ===
You can also create a new page by adding a link to an existing page, then saving that page, and then clicking on the link you created. Use <nowiki>[[Double Brackets]]</nowiki> to add a link to a wiki page (whether or not it already exists). The text within the double brackets denotes the page title (and '''should not''' include ""wiki.occupyboston.org/wiki/"). I can place a link the the homepage by writing "<nowiki>[[Occupy Boston|link text]]</nowiki>", which looks like this: "[[Occupy Boston|link text]]".
To check your occupyboston.org email address go to [https://members.mayfirst.org the May First/People Link member page] choose boggs as the server and enter your username and password.


For other email related questions check these [https://support.mayfirst.org/wiki/faq#EmailRelated FAQs].
===Rename (Move) and REDIRECT===
'Moving' a page is really just creating a new page with the same information while simultaneously redirecting the old page. Everyone has the right to Move pages as they wish. Click the down-arrow to the right of the 'Edit' tab to rename a page.


=== Managing Mailing Lists ===
Use <nowiki>#REDIRECT [[Page Name]]</nowiki> to manually re-direct pages. This works with or with-out deleting the rest of a page's content.
If you need to manage your mailing list, please read over these [https://support.mayfirst.org/wiki/faq#MailmanEmailListRelated FAQs].  If you cannot find and answer to your question, email obit@lists.mayfirst.org and ask for assistance.


We use software called Mailman for mailing lists. You can change how your address appears on the list by logging into the mailing list at
===Categories===
https://lists.mayfirst.org/mailman/listinfo/LIST_NAME and changing your settings.
[[Special:Categories]] automatically updates based upon the category tags of other pages. If you click the edit function of this help page and view with WikiText Editor (not RichText), you can scroll to the bottom of this page and see the Help category tag, which looks like this: <nowiki>[[Category:Help]]</nowiki>. Adding pages to categories is as simple as that. The wiki will do the work of adding a category list at the bottom of your pages. For more specific category help, see WikiMedia's [http://meta.wikimedia.org/wiki/Help:Category Help:Category] page.


If you do not know your password, you can put your email address in at the bottom and click submit and receive a password reminder, then you can log in. To keep your membership hidden, visit the page at https://lists.mayfirst.org/mailman/options/LIST_NAME - you will see an option that says "Conceal yourself from subscriber list?" check the "Yes" box, and save your options.
===Sub-Spaces===
Every page can be used as a 'sub-space'. The title of the page denotes the sub-space it falls into (such as [[User:OneKarma/Forum]] falls into [[User:OneKarma]]), and the wiki will automatically place a link at the top of those pages going 'back' to the sub-space.


This can also be set globally by the list administrator, so you might want to ask on the list itself to have this option turned off.
Use of sub-space can increase the wiki's level of organization, which can allow new users to become more productive, while increasing the depth of user communication.


If you need to set up a new email address email obit@lists.mayfirst.org and someone will set up a list for you.
==Editing==
The 'Edit' tab (top right) allows you to edit anything and everything on a page.  
* Practice editing a page in the [[Sandbox]].
* Nothing can ever be truly un-done - '''every edit is archived''' within the History of each page.


==== List Moderation and Notices to List Owners ====
==='Rich' vs. 'Wiki' Text Editors===
In your Preferences (link in very top right, when signed-in) you can change the default settings for editing, otherwise you can choose which editor to use by clicking the link over the top left of the editing box. You will see either [Show RichTextEditor] or [Show WikiTextEditor]. It is recommended that everyone become familiar with the WikiText Editor in order to keep our Formatting very simple. In 'Rich' mode, you will see the page almost exactly as it will appear when saved, and in 'Wiki' mode you will see all the formatting notation. Observe a few 'Edit' pages in WikiText mode to get a handle on things.


the trick for reducing the number of notices is to set the filter here:
===Formatting===
Use <nowiki><br></nowiki> for a new line where you don't want a larger space to appear. Otherwise, just skip an extra line.<br>
Use <nowiki><nowiki>this command</nowiki></nowiki> to disable automatic formatting, such as '''<nowiki>'''bold'''</nowiki>''', ''<nowiki>''italic''</nowiki>'' (using 3 or 2 apostrophes, respectively), and <u><nowiki><u>underline</u></nowiki></u> commands.


https://lists.mayfirst.org/mailman/admin/EMAIL_LIST_NAME/privacy/sender
====Lists, Headings, and the Table of Contents====
;Use a semicolon (;) at the beginning of a line to create a bold list heading (like this)
:Use a colon (:) at the beginning of a line for an internal heading (like this)
::Add layers of internal headings with multiple colons (this line begins with two colons)
*Use an asterisk (*) or a number sign (#) at the beginning of each line to create a list (this line begins with *)
*#You can embed numbers, bullets, colons, and semicolons within each other (this line begins with *#)
;Use page-defining headings (with 'equals' signs) to create sections and sub-sections on a page.
:It is recommended to <u>always skip</u> the <nowiki>=First Heading=</nowiki> (which is generally reserved for the Title of the page), and
:Use <u>only</u> the <nowiki>==Second==, ===Third===, and ====Fourth====</nowiki>, headings, etc.
;The presence of at least 4 headings on a page will automatically create a <u>table of contents</u> above the first heading.
:To disable the table of contents, place <nowiki>__NOTOC__</nowiki> anywhere on the page.
:Place the table of contents elsewhere by using <nowiki>__TOC__</nowiki>


"Action to take for postings from non-members for which no explicit
===Links===
action is defined" -> Accept
* '''Internal''' links are made with ''double brackets'', such as <nowiki>[[Page Name]]</nowiki> ''(note that Capitalization is important)''
** Use a 'pipe' character (| - appears on my keyboard as 'shift+backslash', above 'enter') to separate display text for internal links, like this: <nowiki>[[Page Name|Link Text]]</nowiki>
* '''External''' links are made with ''single brackets'', such as <nowiki>[http://someurl.com Link Text]</nowiki>
* '''Inter-wiki''' links can be made to some other mediawiki sites. For example, use <nowiki>[[wikipedia:Page Name|link text]]</nowiki> for [[wikipedia:Main Page|Wikipedia]] and <nowiki>[[wikt:Page Name|link text]]</nowiki> for [[wikt:Main Page|Wiktionary]] pages.


The filter here:
===Files===
* ''Upload files'' (texts, images, videos, etc) from your computer via the link on the bottom of the left side-bar.


https://lists.mayfirst.org/mailman/admin/EMAIL_LIST_NAME/privacy/subscribing
===Adding Notes===
Notes about format, language, or missing information often belong right on the page. These are apart from the general Discussion, which can be accessed via the tab at the top left of the page. Notes should mark issues that can be completed by a single individual who happens to know the solution to the noted issue.
* Notes should be in single brackets and announced as a note. [Note: This is an example of a note.]
* Don't forget your signature (using <nowiki>~~~~</nowiki>), otherwise no one will know how to collaborate with you!


"What steps are required for subscription?" -> Confirm
==Additional Resources==
* Editing and formatting: http://meta.wikimedia.org/wiki/Help:Editing#Editing_Basics
* General: http://meta.wikimedia.org/wiki/Help:Contents
* Images: http://www.mediawiki.org/wiki/Help:Images
* Magic Words: http://meta.wikimedia.org/wiki/Help:Magic_words
* HTML: http://www.tedmontgomery.com/tutorial/index.html
* MayFirst email accounts: http://wiki.occupyboston.org/wiki/WG/OBIT/MayFirst_Email_Help
Please contact [[WG/OBIT]] to address any other concerns. They can often be found in the IRC channel '#OccupyBostonIT'


The filter here:
[[Category:Help]]
 
https://lists.mayfirst.org/mailman/admin/EMAIL_LIST_NAME/general
 
"Should administrator get notices of subscribes and unsubscribes?" -> No
 
With these settings, you shouldn't get any requests for anything.  This
means the lists will be wide open, but it should also permit a more free
flow of information without a bunch of notices.

Latest revision as of 02:37, 31 December 2011

Redirect to:


Welcome to the Occupy Boston wiki Help page. This page is dedicated to helping users understand their 'wiki rights' and use of the basic wiki tools.

To become a user, create an account with the link in the upper right corner. Once logged in, please go to your user-page (click the link at the very top of the page) and add your contact information so that others will be able to collaborate with you. You can also verify your email to get updates. Explore your preferences for more options.

Don't just watch - all users have the rights to read, discuss, edit, move (rename), and create new pages. Use the tabs at the top of the page to navigate 'within' pages. The Page and Discussion tabs distinguish collaborative spaces. Edit, View history, Move, and Watch are the basic functions with which every user should be familiar. This page covers only the most basic tools provided in the wiki software.

User:OneKarma welcomes all wiki- and communication-related inquiries. Email: onekarma.ob@gmail.com
Read Renjender's 5 Second Wiki Lesson.
For precise formatting help, view MediaWiki's help page

Basics

The most difficult part of contributing is writing something that is agreeable to an open group. This wiki has nearly 130 active contributors (as of 29 Nov 2011). There have been various 'message statement' groups that have failed because a strong statement is hard to agree upon in diverse groups. The best way to work is to just write. After you write/create something (whether a personal statement or an encyclopedic page), you can post your work in the appropriate place(s) on the wiki. If the appropriate topic page for your work doesn't seem to exist, create it! Place links on existing pages to your new page. (Use the 'Page' tab for solid facts/agreements, and try to keep the 'Discussion' on its own tab - see editing instructions below for details.)

Learn by Observing and Doing

The best way to learn how to contribute to the wiki is to see what is already here and to determine the similar aspects you would like to see. Use the 'Edit' function on any page to see the formatting for that page. (It is recommended to use the 'WikiText' instead of the 'RichText' Editor, as this offers more precise control.) To switch editors, click the link above the top left of the editing box, to 'Show (other) Editor'.

Every page on the wiki should clearly represent a specific idea. You can clarify the intent of a page (and thereby direct its future use) by adding a precise description of its function, which will strongly promote the healthy growth of the wiki.

Page titles should be short and sweet, and should contain relevant hierarchies if possible. For example, a draft proposal from the Safety WG should be entitled Safety/Proposal X. This creates navigable sub-spaces for our mass of information by automating 'return' links, but only when both the sub-page and the host page exist. For example, if both pages WG and WG/Proposal X exist, a link to WG will automatically appear at the top of the WG/Proposal X page.

  • Etiquette should require no more mention than this.
  • Leave a signature to help people collaborate with you. The wiki will automatically change four tildes (~~~~) into a link to your user-page and a time-stamp when you 'Save' the page. Add solid contact information to your user-page for best results.
  • Internal links are like nerve endings - they pick up and direct information within the whole. Consider the many paths by which collaborators and visitors might want to explore the wiki, and try to create a network with many 'nerve endings'. Information should be linked on any and all relevant pages.

Search

There is a search bar at the top right of every page. It works!

Mailing List Help

For admins of working group mailing lists, OBIT has designed a List Help page (with images) to guide you through the mailing list configuration.

Methodology and Content Rights

Anyone can become a content creator, but no one is ever a content 'owner.' See the cautionary note on every Editing page:

If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.

Wikipedia is standing proof that crowd-sourced content creation and management can be effective on a global web-space.

Etiquette

Before you modify a page, please consider the intent of the existing text. There are many authors, and everyone is making their best contributions.

  • You can 'check-in' with prior editors by using the Discussion and History tabs at the top of every page.
  • If you want others to collaborate regarding your notes, don't forget to sign your comments by inserting four tildes (like this: ~~~~). The wiki will automatically insert a link to your user-page next to a time-stamp for the comment.
  • You can email other users by going to their user-page and clicking the link that appears in the bottom of the side-bar. This will send an email to the address registered with that username.

Public vs Personal Space

As a general guideline, please consider the main structure to be a public face of Occupy Boston. It should have the appearance of professionalism, inviting readers with clarity, brevity, and relevancy.

Every user has their own dedicated userpage. Edit your userpage to add contact information, personal statements, and to organize projects you may be working on. See User:OneKarma for a well-developed example. It is suggested that users keep their contact information, personal statements, projects, and reference collections in their own user web-space. You can also create sub-pages in your user-space with the following naming convention: User:YourName/Page Name.

Tools

Navigating the wiki should be intuitive. If it is not, please let us know! User:OneKarma welcomes all wiki-related inquiries.

The side-bar contains the main navigation links, and you should be able to reach every page on the wiki by following links on various pages. Most of the wiki is contained on the Working Groups pages. Working Groups are ever-growing, as is the list of working groups itself! Don't be shy; add your voice to any and all conversations that interest you.

Page, Discussion, and History

The 'Page' tab (top left) is meant to be a public face regarding the topic/title of the page. Please try to keep these pages organized with the most important information, because many people will see only this part of the page.

The 'Discussion' tab (top left) is meant to be 'conversational' in a way.

There is a 'history' of every page that is automatically archived by the wiki software, so there is never a need to worry about 'losing' information. Use the 'View history' tab on the top right to compare versions of a page.

Signature

Please leave a signature when you add comments to discussions. Insert four tildes, like this: ~~~~, for the wiki to automatically insert this: OneKarma 15:14, 21 November 2011 (EST). Other users may want to collaborate regarding the notes you have added, so your signature will let them know how to find you.

New Pages

All users have the right to create new pages. Creating a new page is as easy as visiting the page you want with your web browser, and clicking 'Create' in the top right. This page was created by typing "wiki.occupyboston.org/wiki/Help" into the url bar, and then clicking 'Create' (note that all pages begin with "wiki.occupyboston.org/wiki/" by default). The title of the page is exactly the same as what follows ""wiki.occupyboston.org/wiki/", so remember to Capitalize where appropriate.

You can also create a new page by adding a link to an existing page, then saving that page, and then clicking on the link you created. Use [[Double Brackets]] to add a link to a wiki page (whether or not it already exists). The text within the double brackets denotes the page title (and should not include ""wiki.occupyboston.org/wiki/"). I can place a link the the homepage by writing "[[Occupy Boston|link text]]", which looks like this: "link text".

Rename (Move) and REDIRECT

'Moving' a page is really just creating a new page with the same information while simultaneously redirecting the old page. Everyone has the right to Move pages as they wish. Click the down-arrow to the right of the 'Edit' tab to rename a page.

Use #REDIRECT [[Page Name]] to manually re-direct pages. This works with or with-out deleting the rest of a page's content.

Categories

Special:Categories automatically updates based upon the category tags of other pages. If you click the edit function of this help page and view with WikiText Editor (not RichText), you can scroll to the bottom of this page and see the Help category tag, which looks like this: [[Category:Help]]. Adding pages to categories is as simple as that. The wiki will do the work of adding a category list at the bottom of your pages. For more specific category help, see WikiMedia's Help:Category page.

Sub-Spaces

Every page can be used as a 'sub-space'. The title of the page denotes the sub-space it falls into (such as User:OneKarma/Forum falls into User:OneKarma), and the wiki will automatically place a link at the top of those pages going 'back' to the sub-space.

Use of sub-space can increase the wiki's level of organization, which can allow new users to become more productive, while increasing the depth of user communication.

Editing

The 'Edit' tab (top right) allows you to edit anything and everything on a page.

  • Practice editing a page in the Sandbox.
  • Nothing can ever be truly un-done - every edit is archived within the History of each page.

'Rich' vs. 'Wiki' Text Editors

In your Preferences (link in very top right, when signed-in) you can change the default settings for editing, otherwise you can choose which editor to use by clicking the link over the top left of the editing box. You will see either [Show RichTextEditor] or [Show WikiTextEditor]. It is recommended that everyone become familiar with the WikiText Editor in order to keep our Formatting very simple. In 'Rich' mode, you will see the page almost exactly as it will appear when saved, and in 'Wiki' mode you will see all the formatting notation. Observe a few 'Edit' pages in WikiText mode to get a handle on things.

Formatting

Use <br> for a new line where you don't want a larger space to appear. Otherwise, just skip an extra line.
Use <nowiki>this command</nowiki> to disable automatic formatting, such as '''bold''', ''italic'' (using 3 or 2 apostrophes, respectively), and <u>underline</u> commands.

Lists, Headings, and the Table of Contents

Use a semicolon (;) at the beginning of a line to create a bold list heading (like this)
Use a colon (:) at the beginning of a line for an internal heading (like this)
Add layers of internal headings with multiple colons (this line begins with two colons)
  • Use an asterisk (*) or a number sign (#) at the beginning of each line to create a list (this line begins with *)
    1. You can embed numbers, bullets, colons, and semicolons within each other (this line begins with *#)
Use page-defining headings (with 'equals' signs) to create sections and sub-sections on a page.
It is recommended to always skip the =First Heading= (which is generally reserved for the Title of the page), and
Use only the ==Second==, ===Third===, and ====Fourth====, headings, etc.
The presence of at least 4 headings on a page will automatically create a table of contents above the first heading.
To disable the table of contents, place __NOTOC__ anywhere on the page.
Place the table of contents elsewhere by using __TOC__

Links

  • Internal links are made with double brackets, such as [[Page Name]] (note that Capitalization is important)
    • Use a 'pipe' character (| - appears on my keyboard as 'shift+backslash', above 'enter') to separate display text for internal links, like this: [[Page Name|Link Text]]
  • External links are made with single brackets, such as [http://someurl.com Link Text]
  • Inter-wiki links can be made to some other mediawiki sites. For example, use [[wikipedia:Page Name|link text]] for Wikipedia and [[wikt:Page Name|link text]] for Wiktionary pages.

Files

  • Upload files (texts, images, videos, etc) from your computer via the link on the bottom of the left side-bar.

Adding Notes

Notes about format, language, or missing information often belong right on the page. These are apart from the general Discussion, which can be accessed via the tab at the top left of the page. Notes should mark issues that can be completed by a single individual who happens to know the solution to the noted issue.

  • Notes should be in single brackets and announced as a note. [Note: This is an example of a note.]
  • Don't forget your signature (using ~~~~), otherwise no one will know how to collaborate with you!

Additional Resources

Please contact WG/OBIT to address any other concerns. They can often be found in the IRC channel '#OccupyBostonIT'