Difference between revisions of "Howto"

From bombaywiki
Jump to: navigation, search
(Formatting text)
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
[https://bombaywiki.with.camp bombaywiki.with.camp] is a collaborative, wiki type, subjective encyclopedia of Bombay.
+
[https://bombaywiki.with.camp bombaywiki.with.camp] is a collaborative, wiki type, subjective encyclopedia of Bombay/Mumbai.
  
 
==== Writing Style ====
 
==== Writing Style ====
 
* This wiki encourages subjective and opinionated writing in its pages.  
 
* This wiki encourages subjective and opinionated writing in its pages.  
* Sources can vary from personal experience, oral sources, reading, newspapers, etc. but it is NOT necessary to reference every fact or claim. Sources in any can be placed in the bottom of a page, under the heading Further Reading. An example is: [[Anna_Bhau_Sathe#Further_Reading:]].
+
* Sources can vary from personal experience, oral sources, books to newspapers, etc. but it is NOT necessary to reference every fact or claim. Bombaywiki is interested in ideas that grow around things, places, people. Authors' particular voices are encouraged, and are credited in the History of each page/ entry. Textual sources if any can be placed in the bottom of a page, under the heading Further Reading. An example is: [[Anna_Bhau_Sathe#Further_Reading:]].
* Do not link to external sites within your pages, place them in Further Reading. Where valid, you should link to pages in this wiki. See the Adding Links section below.
+
* First person accounts are encouraged, and should be placed in <block quotes> eg. [[Mohammad_Umar]].
 +
* Linking to external sites in the text should be done only when absolutely necessary for context, for example to link to the full text of a poem. Place other links and sources in Further Reading. Other pages in the wiki should be linked to where needed. For how-to, see the Adding Links section below.
  
 
==== The Index ====
 
==== The Index ====
is the [[Index|Main Page]] of the wiki. It consists of groups of entities (People, Places, Organizations, Events, Things, Concepts, Interpretations etc), each alphabetically sorted.
+
is the [[Index|Main Page]] of the wiki. It has groups of entities (People, Places, Organizations, Events, Things, Concepts, Interpretations etc), each alphabetically sorted.  
 
* Red links - there is no page yet, page is created by clicking on the red link, to then be populated.
 
* Red links - there is no page yet, page is created by clicking on the red link, to then be populated.
 
* Blue links - links to pages already populated, open to editing.
 
* Blue links - links to pages already populated, open to editing.
  
 
==== To Begin Contributing ====
 
==== To Begin Contributing ====
* Register on [[Index|bombaywiki.with.camp]]: Top-right, click "Guest" -> "Create Account"
+
* Register on [[Index|bombaywiki.with.camp]]: On top-right, click "Guest" -> "Create Account"
* Send us an email to grant you edit access, mention your username<br>  email to: contact+bombaywiki@studio.camp
+
* Send us an email to grant you edit access, and mention your username. Email to: contact+bombaywiki@studio.camp
* Entries are to be added alphabetically per section to the main page which serves as an index/overview of the site.
+
* Entries are to be added alphabetically per section on the main page, which serves as an index/overview of the site. Click the edit button in front of each section to begin.  
** Each entry on this page is a link to a page of that name.
+
** Each entry on this page is a link to a page of that name.  
 
* Creating a new entry in index
 
* Creating a new entry in index
** To create a new entry called "Carrom", click "Edit" next to the title of each section, scroll to appropriate heading and alpahabetical position.
+
** To create a new entry called "Carrom" in section Things, click "Edit" next to the title of Things section, scroll to appropriate alphabetical position.
** Type as below then 'Save':<br>
+
** Create a new line, type as below then 'Save':<br>
 
   <nowiki>[[Carrom]]<br></nowiki>
 
   <nowiki>[[Carrom]]<br></nowiki>
** This creates a link. Click on it, you will see this message:
+
* This creates a link, and a line break after it. Click on the link, you will see this message:
 
  "You have followed a link to a page that does not exist yet. To create the page, start typing in the box below (see the help page for more info). If you are here by mistake, click your browser's back button."<br>
 
  "You have followed a link to a page that does not exist yet. To create the page, start typing in the box below (see the help page for more info). If you are here by mistake, click your browser's back button."<br>
** You can now add text, add links and embed image/audio/video files. Once complete, "Save Changes".
+
* You can now add text, add links and embed image/audio/video files. Once complete, "Save Changes".
** You may use "Show Preview" to see what the page looks like without saving it. Save when satisfied.
+
* You may use "Show Preview" to see what the page looks like without saving it. Save when satisfied.
  
==== Help links and Documentation ====
+
==== Helpful Tips ====
on how to format text, add links, embed images/audio/video files
+
on how to format text, add links, embed images/audio/video files:
  
 
===== Formatting text =====
 
===== Formatting text =====
You can format your text by using wiki markup.<br>
+
You can format your text by using wiki "markup" that is use of symbols to create variations in text style.<br>
** See https://www.mediawiki.org/wiki/Help:Formatting<br>
+
* See https://www.mediawiki.org/wiki/Help:Formatting<br>
** For example:
+
* For example:
 
{| class="wikitable" style="margin: auto;"
 
{| class="wikitable" style="margin: auto;"
 
|'''what you type'''
 
|'''what you type'''
Line 46: Line 47:
 
|}
 
|}
  
** Creating headings within a page
+
* Creating headings within a page
Headings can be level 2-6 (most practically 3-6), created by enclosing text in "=" on a new line ,as per heading level.<br> Do not put any text on the same line after the ending equal signs.<br> An article with 4 or more headings automatically creates a table of contents.
+
Headings can be of levels 2-6 (most practically 3-6), created by enclosing text in "=" on a new line ,as per heading level.<br> Do not put any text on the same line after the ending equal signs.<br> '''An article with 4 or more headings automatically creates a table of contents.'''
  
 
  <nowiki>=== Heading Level 3 ===</nowiki>
 
  <nowiki>=== Heading Level 3 ===</nowiki>
Line 53: Line 54:
 
  <nowiki>===== Heading Level 5 =====</nowiki>
 
  <nowiki>===== Heading Level 5 =====</nowiki>
  
** Paragraphs
+
* Paragraphs
 
MediaWiki ignores single line breaks. To start a new paragraph, leave an empty line.<br> You can force a line break within a paragraph with the HTML tag <nowiki><br></nowiki>
 
MediaWiki ignores single line breaks. To start a new paragraph, leave an empty line.<br> You can force a line break within a paragraph with the HTML tag <nowiki><br></nowiki>
  
** Start a line with a space to create a "box" in which your text will appear.
+
* Start a line with a space to create a "box" in which your text will appear.
 
  This is pre-formatted text which appears in a "box".
 
  This is pre-formatted text which appears in a "box".
  
Line 62: Line 63:
 
* See detailed documentation: https://www.mediawiki.org/wiki/Help:Links
 
* See detailed documentation: https://www.mediawiki.org/wiki/Help:Links
 
Internal link basic format:  
 
Internal link basic format:  
  <nowiki>[[target-link|what to display]]</nowiki>
+
  <nowiki>[[target-item|text-displayed]]</nowiki>
 
External link basic format:
 
External link basic format:
  <nowiki>[[url link-text]]</nowiki>
+
  <nowiki>[[url text-displayed]]</nowiki>
  
 
* Some examples:
 
* Some examples:
Line 109: Line 110:
  
 
===== Embedding video from external sites =====
 
===== Embedding video from external sites =====
* [https://wiki.pad.ma/wiki/embed Pandora based sites (pad.ma or indiancine.ma)]
+
* [https://wiki.pad.ma/wiki/embed From pad.ma or indiancine.ma]

Latest revision as of 17:56, 27 November 2017

bombaywiki.with.camp is a collaborative, wiki type, subjective encyclopedia of Bombay/Mumbai.

Writing Style

  • This wiki encourages subjective and opinionated writing in its pages.
  • Sources can vary from personal experience, oral sources, books to newspapers, etc. but it is NOT necessary to reference every fact or claim. Bombaywiki is interested in ideas that grow around things, places, people. Authors' particular voices are encouraged, and are credited in the History of each page/ entry. Textual sources if any can be placed in the bottom of a page, under the heading Further Reading. An example is: Anna_Bhau_Sathe#Further_Reading:.
  • First person accounts are encouraged, and should be placed in <block quotes> eg. Mohammad_Umar.
  • Linking to external sites in the text should be done only when absolutely necessary for context, for example to link to the full text of a poem. Place other links and sources in Further Reading. Other pages in the wiki should be linked to where needed. For how-to, see the Adding Links section below.

The Index

is the Main Page of the wiki. It has groups of entities (People, Places, Organizations, Events, Things, Concepts, Interpretations etc), each alphabetically sorted.

  • Red links - there is no page yet, page is created by clicking on the red link, to then be populated.
  • Blue links - links to pages already populated, open to editing.

To Begin Contributing

  • Register on bombaywiki.with.camp: On top-right, click "Guest" -> "Create Account"
  • Send us an email to grant you edit access, and mention your username. Email to: contact+bombaywiki@studio.camp
  • Entries are to be added alphabetically per section on the main page, which serves as an index/overview of the site. Click the edit button in front of each section to begin.
    • Each entry on this page is a link to a page of that name.
  • Creating a new entry in index
    • To create a new entry called "Carrom" in section Things, click "Edit" next to the title of Things section, scroll to appropriate alphabetical position.
    • Create a new line, type as below then 'Save':
  [[Carrom]]<br>
  • This creates a link, and a line break after it. Click on the link, you will see this message:
"You have followed a link to a page that does not exist yet. To create the page, start typing in the box below (see the help page for more info). If you are here by mistake, click your browser's back button."
  • You can now add text, add links and embed image/audio/video files. Once complete, "Save Changes".
  • You may use "Show Preview" to see what the page looks like without saving it. Save when satisfied.

Helpful Tips

on how to format text, add links, embed images/audio/video files:

Formatting text

You can format your text by using wiki "markup" that is use of symbols to create variations in text style.

what you type text enclosed in to see
'''bold''' 3 single quotes bold
''italic'' 2 single quotes italic
  • Creating headings within a page

Headings can be of levels 2-6 (most practically 3-6), created by enclosing text in "=" on a new line ,as per heading level.
Do not put any text on the same line after the ending equal signs.
An article with 4 or more headings automatically creates a table of contents.

=== Heading Level 3 ===
==== Heading Level 4 ====
===== Heading Level 5 =====
  • Paragraphs

MediaWiki ignores single line breaks. To start a new paragraph, leave an empty line.
You can force a line break within a paragraph with the HTML tag <br>

  • Start a line with a space to create a "box" in which your text will appear.
This is pre-formatted text which appears in a "box".
Adding links

Internal link basic format:

[[target-item|text-displayed]]

External link basic format:

[[url text-displayed]]
  • Some examples:
what you type to see link type
[https://pad.ma]
[https://pad.ma/CW]
[1]
[2]
link to external site, no link-text
Multiple links of this type on
the same page are numbered sequentially.
[https://pad.ma video archive] video archive link to external site, link-text "video archive"
[[Anna Bhau Sathe]] Anna Bhau Sathe internal link within bombaywiki
[[Anna_Bhau_Sathe#SHORT_STORIES|Anna's short stories]] Anna's short stories internal link to specific section, hyperlink
Uploading files
  • Files (png, gif, jpg, jpeg, webp, pdf, webm, mp4, mp3) can be uploaded, to embed or link-to as required on pages.
  • Filename should be complete and informative.
    For example: Books should have author, title, publication year in the title)
  • Documents (PDF) and images should be uploaded at their original resolution. You can resize them for viewing later.
  • Maximum file size is 64MB.
  • To upload click "Upload File" button, top-left on bombaywiki.
  • Add a summary or description or tags in the "Summary" section of the upload file form.
    Click "Upload File" button at bottom of the page.
  • To find and use uploaded files see these links in bombaywiki left-panel:
    • All Files
      - list of all files uploaded to the wiki in a tabular format with title, metadata, description visible
      - can be sorted by any field by clicking on field heading.
    • Recent Files
      - list of recently uploaded files, title with thumbnail.
    • Note: click on a file in the list takes you to the file description page.
  • More help: https://www.mediawiki.org/wiki/Help:Managing_files
Using files
Embedding video from external sites