Difference between revisions of "Howto"
(→Writing Style) |
|||
(14 intermediate revisions by 2 users 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, | + | * 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 ==== | ==== The Index ==== | ||
− | is the [[Index|Main Page]] of the wiki. It | + | 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]]: | + | * 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 | + | * 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 | + | * 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 | + | ** 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':<br> |
<nowiki>[[Carrom]]<br></nowiki> | <nowiki>[[Carrom]]<br></nowiki> | ||
− | + | * 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 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 | + | 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> | |
− | + | * For example: | |
{| class="wikitable" style="margin: auto;" | {| class="wikitable" style="margin: auto;" | ||
|'''what you type''' | |'''what you type''' | ||
Line 45: | Line 47: | ||
|} | |} | ||
− | + | * Creating headings within a page | |
− | Headings can be | + | 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 52: | Line 54: | ||
<nowiki>===== Heading Level 5 =====</nowiki> | <nowiki>===== Heading Level 5 =====</nowiki> | ||
− | + | * 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. | ||
+ | This is pre-formatted text which appears in a "box". | ||
===== Adding links ===== | ===== Adding links ===== | ||
* 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- | + | <nowiki>[[target-item|text-displayed]]</nowiki> |
External link basic format: | External link basic format: | ||
− | <nowiki>[[url | + | <nowiki>[[url text-displayed]]</nowiki> |
* Some examples: | * Some examples: | ||
Line 105: | Line 110: | ||
===== Embedding video from external sites ===== | ===== Embedding video from external sites ===== | ||
− | * [https://wiki.pad.ma/wiki/embed | + | * [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.
Contents
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.
- See https://www.mediawiki.org/wiki/Help:Formatting
- For example:
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
- See detailed documentation: https://www.mediawiki.org/wiki/Help: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.
- All Files
- More help: https://www.mediawiki.org/wiki/Help:Managing_files
Using files
- To Link and Display files see links in bombaywiki left-panel: