Difference between revisions of "Author Help"
(removed content to new page Article Structure) |
|||
Line 1: | Line 1: | ||
Dharmawiki article structure has many features that are user friendly both for the Authors as well as the Readers. Wiki software enables the [[Article Structure|article structure]] to be built in a user friendly way. | Dharmawiki article structure has many features that are user friendly both for the Authors as well as the Readers. Wiki software enables the [[Article Structure|article structure]] to be built in a user friendly way. | ||
− | Creating Articles is elaborated here in the further sections (More information is available in the [http://meta.wikimedia.org/wiki/Help:Contents User's Guide] for information on using the wiki software.) | + | Creating and Formatting Articles is elaborated here in the further sections (More information is available in the [http://meta.wikimedia.org/wiki/Help:Contents 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: | |
− | + | #Knowing how to begin editing | |
− | + | #Adding text | |
− | + | #Making existing text bold | |
− | + | #Making existing text italicized | |
− | + | #Creating a new subsection, with correct subheading level and section content | |
− | + | #Adding a citation | |
− | + | #Editing a citation | |
− | + | #Adding an internal wikilink | |
− | + | #Removing an internal wikilink | |
− | + | #Adding an external link to the External Links section | |
+ | #Finalizing/saving edits | ||
== Create New Page == | == Create New Page == | ||
Line 42: | Line 43: | ||
=== From a New Search === | === 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. | 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. | ||
− | [[File: | + | |
+ | <figure-inline class="mw-default-size mw-image-border">[[File:Search_Results.JPG|544x544px]]</figure-inline> | ||
* Type the name of the page that doesn't exist in the Search box, and start the search. | * Type the name of the page that doesn't exist in the Search box, and start the search. | ||
Line 100: | Line 102: | ||
=== Paragraph Style === | === 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. | + | 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. |
[[File:Paragraph Styles.png|none|thumb|400x400px|'''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. | [[File:Paragraph Styles.png|none|thumb|400x400px|'''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 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 rare exceptions). [[File:Text Formats.PNG|none|thumb|447x447px|'''List of 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). [[File:Text Formats.PNG|none|thumb|447x447px|'''List of Text Formatting Styles''']] |
=== Language === | === Language === | ||
− | Samskrit language is used for slokas, mantras and phrases as may be required. | + | While english is used widely, other languages such as Samskrit language is used for slokas, mantras and phrases as may be required. Editing 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. |
+ | [[File:Symbol for Devanagari.png|none|thumb|340x340px|'''Accessing Devanagari characters''']] | ||
=== Interlinking of Articles === | === 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 | 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. | 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. | ||
+ | [[File:Hyperlink 1.PNG|none|thumb|340x340px|'''Inter-Linking of Articles''']] | ||
* [[Guidelines for Authors and Editors|Guidelines]] for Authors and Editors | * [[Guidelines for Authors and Editors|Guidelines]] for Authors and Editors | ||
* Content Formatting Policies | * Content Formatting Policies | ||
* Technical matters | * Technical matters | ||
[[Category:About Dharmawiki]] | [[Category:About Dharmawiki]] |
Revision as of 15:56, 8 March 2019
Dharmawiki article structure has many features that are user friendly both for the Authors as well as the Readers. Wiki software enables the article structure to be built in a user friendly way.
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:
- Knowing how to begin editing
- Adding text
- Making existing text bold
- Making existing text italicized
- Creating a new subsection, with correct subheading level and section content
- Adding a citation
- Editing a citation
- Adding an internal wikilink
- Removing an internal wikilink
- Adding an external link to the External Links section
- 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.
- Dos and Donts for a Guest Author
- Dharma Point of View which defines the Content Policies for Dharmawiki
- Guidelines for Authors and Editors defines the content guidelines used on the site and software usage
- Contact a Dharmawiki Editor for any guidance during creating a new page
A new page can be created in one of the following three ways :
- From a Link
- From a New Search
- 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.
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.
- 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.
<figure-inline class="mw-default-size mw-image-border"></figure-inline>
- 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
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.
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.
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. 'Edit Source' mode is preferred 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
Bullet lists helps the author present data in clear and crisp manner, in short sentences. Bullet lists cannot be indented.
Numbered Lists
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.
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).
Language
While english is used widely, other languages such as Samskrit language is used for slokas, mantras and phrases as may be required. Editing 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.
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.
- Guidelines for Authors and Editors
- Content Formatting Policies
- Technical matters