User:Mcktimo/on organizing the wiki/help file: Difference between revisions

From wiki.occupyboston.org
Jump to navigation Jump to search
(Created page with "code snippet for automatic bibliography: <pre> =====References===== {{:sources:biblio}} <biblio force=false> #mysource author, title, publisher </biblio> </pre> ==help on the con...")
 
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
code snippet for automatic bibliography:
===general notes on organization===
<pre>
: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.
=====References=====
 
{{:sources:biblio}}
:This wiki (Mediawiki(same software that runs Wikipedia) allows the creation of webspaces for each user and working group.
<biblio force=false>
 
#mysource author, title, publisher
====personal webspaces====
</biblio>
: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.  
</pre>
==help on the content==
The content is continuously evolving and is subject to change. If something is unclear or broken contact the teacher, Tim McKenna at mrmckenna@pathboston.com


==wiki help==
====working groups - pages a workspaces====
:Working groups can have a public face and a group workspace. Create a working group 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====
=====to link to pages on the wiki=====
:Put a link using double brackets and the name at the top of the page like this <nowiki>[[page name]]</nowiki>
=====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...
===to create a login account on occupyboston wiki===
#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)===
===Creating content (basic)===
Creating your own content is easy. You can edit any page by clicking on '''Edit this page (bottom or sidebar)''' . You can comment on any page by  
: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)
clicking on '''Discuss Page (bottom or sidebar)''' or '''Post a Comment (sidebar)'''. After you add your content sign it by clicking on the '''signature button''' (the second button from the right on top) then '''save page (bottom)'''.


====creating content in your webspace====
====creating content in your webspace====
1st make sure you are logged in.
: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. Hit '''save page''' (at the bottom of the page) to save your work. Do it often!
: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 subdirectory in your webspace====
:To set up a subdirectory put this code in your webspace:
<pre>[[/subpage name]]</pre>
:(the '/' is important)
:Save the page and then click on the new link to get into the directory.


====making a table of contents and titles/heading====
====making a table of contents and titles/heading====
To organize your work give each piece of writing its own title. To create a title, type, on its own line:<br>
:To organize your work give each piece of writing its own title. To create a title, type, on its own line:<br>
<nowiki>==your title here==</nowiki>
<nowiki>==your title here==</nowiki>
=====making <nowiki>__NOTOC__</nowiki>=====
=====making <nowiki>__NOTOC__</nowiki>=====
put that at the top of your page
:Put that at the top of your page if you don't want to show a table of contents.


====don't erase your work====
====you cannot erase====
Researchers say students learn to write better by seeing the progress of their writing as they revise. Please don't erase anything.
:You can always get back to a prior version of the page by clicking on it in '''view history'''(top right)
When you revise copy your existing work and paste it above. Edit the heading. Like...<br>
<nowiki>==my piece -version 2==</nowiki>


====taking notes, creating lists====
====taking notes, creating lists====
To organize your notes you can use bullet lists and numbered lists. To create a bullet list like this
To organize your notes you can use bullet lists and numbered lists. To create a bullet list like this
*first point
*first point
*onother point
*another point
*etc
*etc
just start a line with an *
just start a line with an *
Line 43: Line 59:
#third
#third
just start each line with a # symbol (don't skip lines)
just start each line with a # symbol (don't skip lines)
====creating a subdirectory in your webspace====
Most of your work will be collected by writing project. Each writing project will be in its own subdirectory. In the url you will see: http://pathboston.com/hum/username/aproject.
to set up a subdirectory put this code in your webspace:
<pre>===[[/a project name]]===</pre>
(the / is important)
Save the page and then click on the new link to get into the directory.


====writing a poem====
====writing a poem====
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
: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 (EXTENSION NEEDED)
<pre>
<pre>
<poem>
<poem>
Line 61: Line 70:
</pre>
</pre>


Another way to prevent word wrap is to put <nowiki> <br> </nowiki> at the end of a line. The next line will stay on the next line when you save.
:Another way to prevent word wrap is to put <nowiki> <br> </nowiki> at the end of a line. The next line will stay on the next line when you save.


Another way to prevent word wrap is to just skip a line.
:Another way to prevent word wrap is to just skip a line.


==== using the graphical editor====
==== using the graphical editor====
A graphical editor is slower. If you really want to use a graphical editor see me and I'll set it up.  
:A graphical editor is a little slower. It hides the guts of the wiki markup language.


==== if the internet is s l o w ====
==== moving stuff from Word? ====
Write in Word. Single spaced, do not indent first lines, skip lines between paragraphs. Copy and paste into the wiki when you are done.
:Write in Word. Single spaced, do not indent first lines, skip lines between paragraphs. Copy and paste into the wiki when you are done.
====to create a login account for occupyboston wiki====
 
#click-on the '''''login/create_account button''''' in the upper right corner
There are many other cool things you can try that create nice pages...
#click on "Create an Account"
#Put in username, password and email


==other help==
==other help==
Line 80: Line 87:
http://meta.wikimedia.org/wiki/Help:Contents
http://meta.wikimedia.org/wiki/Help:Contents


[http://www.tedmontgomery.com/tutorial/index.html editing HTML]
A lot of HTML will work in the wiki. Try [http://www.tedmontgomery.com/tutorial/index.html editing HTML]


===[[SandBox]]===
===[[SandBox]]===
To try out formattng and editing features use this space
:To try out formattng and editing features use this space
===[http://www.mediawiki.org/wiki/Help:Images help:images]===
===[http://www.mediawiki.org/wiki/Help:Images help:images]===
===Customizing===
(need to change LocalSettings.php and uncoment or add:
Please see [http://meta.wikipedia.org/wiki/MediaWiki_i18n documentation on customizing the interface]
:$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ppt', 'pdf', 'doc', 'psd', 'mp3','xls', 'zip','swf', 'bmp', 'tiff', 'tif', 'mp4', 'mov', 'flv');
and the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for usage and configuration help.
:$wgAllowExternalImages = true;
 
===[http://meta.wikimedia.org/wiki/Help:Magic_words Magic Words]===
===[http://meta.wikimedia.org/wiki/Help:Magic_words Magic Words]===
 
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.
 
 
* '''Etiquette should''' require no more mention than this.
* Before you begin editing, please quickly '''browse the navigation bar''' on the left to get a feel for the structure of our wiki.
 
* '''Internal links''' are like red blood cells and nerve endings.
** Consider the many paths by which collaborators and visitors may explore the wiki, and try to create a network with '''many''' 'nerve endings.'
* '''Regarding Discussion:'''
** Every page has its own Discussion! Make sure to post on the relevant page.
** The Discussion is meant to house '''conversation''' between members.
*** Please add comments to existing discussions - that's why they're there!
*** Conversation is greatly aided by query; Where there is a question, there shall become an answer.
* '''Making a LARGE contribution?'''
** Are you posting a document that is hosted only on your personal computer?
*** Please '''do not''' create a new page or a new Discussion topic to 'host' a text.
*** Please click on 'Manage Wiki' in the top of the navigation bar, then under Content click on 'Files.' Here you can upload documents from your computer, and then revert to the next step:
** Are you posting text, video, or audio that is '''already hosted online?'''
*** Please post a link and a short description on the appropriate existing page (often in the [[Press]] section).
* '''Please note the large number of pages that already exist!''' Your contribution might be best hosted on an existing page.
* '''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.]

Latest revision as of 01:07, 23 October 2011

general notes on organization

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.
This wiki (Mediawiki(same software that runs Wikipedia) allows the creation of webspaces for each user and working group.

personal webspaces

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.

working groups - pages a workspaces

Working groups can have a public face and a group workspace. Create a working group account following the convention User:WG-groupname and create internal working group content as subpages of User:WG-groupname (see below)

referencing other documents

to link to pages on the wiki
Put a link using double brackets and the name at the top of the page like this [[page name]]
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 [http://urlofpage.com/page]

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

to create a login account on occupyboston wiki

  1. click-on the login/create_account button in the upper right corner
  2. click on "Create an Account"
  3. Put in username, password and email

Creating content (basic)

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 ~~~) then save page (bottom).Mcktimo 00:47, 23 October 2011 (EDT)

creating content in your webspace

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 subdirectory in your webspace

To set up a subdirectory put this code in your webspace:
[[/subpage name]]
(the '/' is important)
Save the page and then click on the new link to get into the directory.

making a table of contents and titles/heading

To organize your work give each piece of writing its own title. To create a title, type, on its own line:

==your title here==

making __NOTOC__
Put that at the top of your page if you don't want to show a table of contents.

you cannot erase

You can always get back to a prior version of the page by clicking on it in view history(top right)

taking notes, creating lists

To organize your notes you can use bullet lists and numbered lists. To create a bullet list like this

  • first point
  • another point
  • etc

just start a line with an *
For a numbered list

  1. first
  2. second
  3. third

just start each line with a # symbol (don't skip lines)

writing a poem

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 (EXTENSION NEEDED)
<poem>
Here is a poem
It is not very poetic
Is it
</poem>
Another way to prevent word wrap is to put <br> at the end of a line. The next line will stay on the next line when you save.
Another way to prevent word wrap is to just skip a line.

using the graphical editor

A graphical editor is a little slower. It hides the guts of the wiki markup language.

moving stuff from Word?

Write in Word. Single spaced, do not indent first lines, skip lines between paragraphs. Copy and paste into the wiki when you are done.

There are many other cool things you can try that create nice pages...

other help

Editing and Formatting

http://meta.wikimedia.org/wiki/Help:Contents

A lot of HTML will work in the wiki. Try editing HTML

SandBox

To try out formattng and editing features use this space

help:images

(need to change LocalSettings.php and uncoment or add:

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ppt', 'pdf', 'doc', 'psd', 'mp3','xls', 'zip','swf', 'bmp', 'tiff', 'tif', 'mp4', 'mov', 'flv');
$wgAllowExternalImages = true;

Magic Words

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.