Author Help

From Dharmawiki
Jump to navigation Jump to search

Dharmawiki article structure has many features that are user friendly both for the Authors as well as the Readers. Wiki software is flexible and hence the article structure in this site undergoing refinements as we go along. Creating and Formatting Articles is elaborated here in the further sections (More information is available in the User's Guide for information on using the wiki software.)

New authors are required to familiarize themselves with the software guidelines for editing or formatting as follows:

  1. Knowing how to begin editing
  2. Adding text (using language keyboard)
  3. Making existing text bold, italicized and using other formatting tools
  4. Creating a new subsection, with correct subheading level and section content
  5. Addition of and editing a citation (for adding references)
  6. Making tables, column-lists and using other such features
  7. Addition and removal of flagging templates (against a specific line as well as the whole article)
  8. Addition and removal of an internal link (inter-linked articles within the site)
  9. Addition and removal of an external links (linking an article to external sites)
  10. Finalizing/saving edits

Create New Page

A brand new author can access the links to Create a New Page only after he/she gets logged in. Authors should familiarize themselves with the following documents before attempting to create content on the site.

A new page can be created in one of the following three ways :

  1. From a Link
  2. From a New Search
  3. From a URL

From a link

Once logged in with their credentials, Authors may click on the Create New Page link on the Side bar or on top of the Article next to the Discussion Page to Create a New Page with appropriate title format as defined in the standard Formating Guidelines. Once created the content can be added into the page in a simple way.

 
Create New Page Link in Sidebar
 
Create New Page Link on Top of Banner

Some pages contain red links such as the one seen below. They are typically like place holders and prompts to other pages that don't exist yet (do not have content in them) and are generally required for completing the concepts.

 
Example of a Red Link
  • To create a new page from one of these click on the red link. They are typically created in preparation for leading to creation of a new page from an existing page.
  • Check the spelling of the title and whether it is in the required format before creating the page. Make sure that the site does not contain a duplicate entry of the same page and if the content is found under another similar name page.
  • If there isn't already a new page link to the page you want to create, you can always add such a link yourself. You would add the new page link typically in a related page, an index page or your own user page.
  • Once a page is created from the red link, refresh the original article which led you to this page, the link becomes blue in color indicating that the page now has content.

From a New Search

Another way to create a new page is when you notice a search is not returning any results of valid nature. The search results shows a red linked word which can be potentially created as a new page by following the steps as described above.

 
Example of Creating a page from Search Results
  • Type the name of the page that doesn't exist in the Search box, and start the search.
  • The search results will say that no such page exists. You can create a new page by clicking on the 'red linked' name.

From a URL

 
Example of entering the requested title in URL

The third way to create a new page is by directly typing the required page (eg. Adhikara) in the URL in the address bar of the browser. It is one of the easiest ways to create a new page. You could edit that and press enter. If the typed page does not exist, you can create a new page by clicking on 'create this page' link.

New Page Vs Blank Page

A 'non-existing' or a new page does not have a history, whereas a 'blank' page has a page 'history', although it does not have any content. A non-existing page is created whereas a blank page is created but has no content inside it.

  • Creating a new page is just like editing a blank page.
  • To create an empty page, save a page with the wikitext __END__. This code will not be saved, it just prevents refusal by the system to create an empty page.
 
Example of a non-existing page
 
Example of Blank Page without content
 
Example of history of Blank Page : Date and time stamp of creation of the page

Adding Content in a New Page

After a new page is created, you can add content to it by going to 'Edit' mode or 'Edit Source' mode. You can add content into a new page by just typing it out.

 
Click on Edit button.
 
Start typing in the space below the title.
 
Save your work by clicking on Save Changes.

As you can see once you start typing the Save Changes button gets activated from gray to blue.

  • 'Edit' mode is preferred to edit text content. This tutorial guides one on making simple formatting changes from this mode. 'Edit Source' mode is a little complex and is used to edit tables, image indents, hyperlinks etc.
  • When you have finished adding your initial text, click on 'Save page'. The new page will be created.

You will need internet connection to save the changes you made for the content to be uploaded and saved in the site. Always check the following before creating a new page

  • whether a page of the same or similar title exists
  • the content in that similar page is appropriate and relevant
  • if the title of the page is according to the format scheme on the site. See Format Guidelines.

Formatting Content in a Page

Once you start adding content in a page by typing it out, you will need simple formatting tools to present your data clearly. An array of formatting tools open up only when you are in the edit mode. The following pictures outline the buttons used to add the various formatting styles supported by Mediawiki.

Bullet Lists

 
To Insert Bullet Points click on the bullet list as highlighted

Bullet lists helps the author present data in clear and crisp manner, in short sentences. Bullet lists cannot be indented.

Numbered Lists

 
To insert Numbered Lists click on the numbered list as highlighted

Decreasing and increasing the indentation is possible for numbered lists

Paragraph Style

To make headings and subheadings the Paragraph tab has to be accessed. Once the words are in these formats they do not accept the bullet point and numbered lists patterns. For example, Headings cannot be in bullet points.

 
List of Paragraph Styles

The drop down list shows the different styles and their visibility on the page when used. Page Title cannot be used in general during the editing process within the page content.

Text Formatting Styles

Text formatting tools include the following, a small number of them, as seen in the drop down list. Mostly one would require the Bold and Italic texts for the articles on this portal (to maintain consistency uniformly). Other tools such as Underline, Subscript, Superscript are not used on the site. The font size also is to be maintained normal neither big nor small (with very rare exceptions).

 
List of Text Formatting Styles

Language

While English is used widely, other languages such as Samskrit language is used for slokas, mantras and phrases as may be required. Editing content in samskrit language can be done either through the keyboard or by clicking on the following symbol and choosing the appropriate language for entering characters. At present transliteration of samskrit slokas and mantras are not facilitated by wiki software. Hence authors have to copy and paste the transliterated slokas from other softwares that offer them.

 
Accessing Devanagari characters

Interlinking of Articles

A very good feature about the wiki software is the ability to connect all related topics through the interlinking feature. Articles and topics tend to become big in the process of making them comprehensive. In such instances appropriate parts of the content can be placed in new pages and referred to in other articles through interlinking. The feature is called hyperlinking and can be accessed by clicking on the highlighted sign as below Once the article is linked it appears blue in color with an underline. On hovering such words a small text box having the link to the new page appears over it, indicating the title of the article.

 
Inter-Linking of Articles

Flags and Pointers

Wiki offers another important tool to identify the content that needs expansion in various ways. We can place flags that draw the attention of the reader to

  • further editing of content (after an author has placed raw data)
  • for clarification of a concept (after an author has placed a perspective)
  • addition of required references
  • addition of more content (when comprehensiveness is required)

To add each template the procedure is similar and easy. Take the cursor to the top line of the page and click on the Insert button in the formatting tools. In the dropdown list select the Template button. All the names are case sensitive.

 
Use Insert and then Template to add flags and pointers

Then add the suitable template selected from the drop-down list. Then press on the Insert button.

 
Select the appropriate template from the dropdown list

Examples of few such templates which can be added by author discretion are as follows.

 
Flag a sentence that needs a reference
 
Template for Flagging an article that needs references. Select NeedCitation in the template list
 
Template for flagging an article that needs further refinement. Select ToBeEdited in the template list.
 
Template for flagging an article that needs expansion. Select StubArticle in the template list.

Adding Categories

Adding categories is important for two reasons

  • to make your page visible in the readers domain
  • to enable sorting to articles
 
Adding a Single or Multiple Categories

Select the highlighted - three lines - button in the formatting panel. From the drop-down list so obtained select Categories. All the names are case sensitive. A new window pops up

 
Adding the required category

More Information

  • Guidelines for Authors and Editors
  • Content Formatting Policies
  • Technical matters