How to Edit Halachipedia: Difference between revisions
No edit summary |
m (grammar) |
||
(73 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
==How to Edit== | |||
===Step 1: Become a user=== | |||
==Step 1: Become a user== | {| | ||
# Create an account by [[Special:UserLogin|clicking here]]. | |- | ||
|{{#ev:youtube|kl6cQvQBbbI}}|| | |||
#Create an account by [[Special:UserLogin|clicking here]]. | |||
#'''Please note, that in order to prevent bots, we have set up a system that allows anyone to create an account, however the account's first edits will not be shown on the default view of the page until the account is approved, which is usually done right after the first edit is made.''' Once the account is approved, all future edits are shown on the default page automatically. Even after a person has an approved account, his edits are still viewed by others to see if they could be improved, but by default they do appear on the finished page. | |||
|} | |||
== How to Create a New Page == | ===Step 2: Learn how to edit=== | ||
{| | |||
|- | |||
|[[Image:EditorToolbar.png|500px]] | |||
#You could pick up wiki code on the go by seeing the code used for pages that are already written. | |||
#Also, you should use the editor toolbar buttons on top of the editor panel which make it a breeze to add bold, italics, references, tables, perform search and replace, and more. | |||
#Alternatively, you could read our brief [[#How_to_Add_Content| help guide below]] before adding content. | |||
|| | |||
{{#ev:youtube|pK9cu6VFYsU}} | |||
|} | |||
==Halachipedia Training== | |||
Every edit or contribution you do makes a tremendous difference for the site as a whole and benefits people all over the world all the time. Yashar Koach or Chazak Ubaruch! | |||
===Editing with Visual Editor or Edit Source=== | |||
{| | |||
|- | |||
|{{#ev:youtube|C4_dXml1Wj0|480}}|| | |||
#After you have [[#Step_1:_Become_a_user|made an account]] you can learn how to edit pages. | |||
#First, go to any page, then click on the edit tab, edit the content, and then save it. | |||
#Alternatively, you can click the edit source tab, edit, and then save. | |||
|} | |||
===Editing Style: Parts of the Halachipedia Page=== | |||
{| | |||
|- | |||
| | |||
#The top of each page should include a short description of the page as well as a picture. | |||
#Sections and subsections should be kept tight to specific topics with ideally 2-4 halachot. It is preferable to break up a large section into multiple subsections than to have one large section. | |||
#At the bottom of every page to render the sources type <references /> or {{Reflist}} | |||
#On the bottom of the page, you can categorize the page. For more info on that see [[#How To Categorize A Page]]. | |||
|| | |||
{{#ev:youtube|TpkmJEHSyHE}} | |||
|} | |||
===Editing Style: Closer Look at Halachipedia Footnotes=== | |||
{| | |||
|- | |||
|{{#ev:youtube|5XrY3mVCKdE}}|| | |||
#Every footnote has accurate and specific sources. It should have at least one. Please do not write a halacha without a source, it will be removed. | |||
#The footnotes can either be just a source or can be a sentence up to 3 paragraphs of description. | |||
#You must look up the sources inside. If you do not look up a source in the primary source, you must quote the secondary source in which you saw it quoted. | |||
|} | |||
==How to Create a New Page== | |||
{| | |||
|Enter the name to create a new page: | |||
|<inputbox> | |||
type=create | |||
break=no | |||
</inputbox> | |||
|} | |||
#Unlike most websites whereby you create a new page and subsequently connect the new page to the main site via a link, in a wiki you first have to create the link and then the page. When you create the link, it will be to a blank page. Then when you click on this blank page, it will give you the option of adding content, so that it’s no longer blank. | |||
#Therefore, the first thing to do is decide where your halachik article would belong within our topical categories as displayed on the left sidebar. | |||
##For instance, “The [[Laws of Shema]]” would fall within the “[[Prayer]]” category. | |||
#Next, you need to create the link. To do this, click the edit tab towards the top of the page. From here you’ll see a large editable text box with all sorts of strange looking coding symbols. Find where you should add your link and surround the title with double brackets | |||
##For instance <nowiki>[[Laws of Shema]]</nowiki> = [[Laws of Shema]] | |||
#A red link means that it's an empty page, which you can then click on and add content | |||
==How to Add Content== | |||
*To make a simple page, there are really only a few codes you should know | *To make a simple page, there are really only a few codes you should know | ||
# Subtopics have <font color=red><nowiki>==</nowiki></font> before and after <font color=red><nowiki>==</nowiki></font> | |||
# Bullet points use the asterisk sign <font color=red><nowiki>*</nowiki></font> | #Subtopics have <font color="red"><nowiki>==</nowiki></font> before and after <font color="red"><nowiki>==</nowiki></font> | ||
# Numbers use the pound sign <font color=red><nowiki>#</nowiki></font> | #Bullet points use the asterisk sign <font color="red"><nowiki>*</nowiki></font> | ||
# References require two things: | #Numbers use the pound sign <font color="red"><nowiki>#</nowiki></font> | ||
## Each individual reference needs <font color=red><nowiki><ref></nowiki></font> before and <font color=red><nowiki></ref></nowiki></font> afterwards | #References require two things: | ||
## And, at the very bottom of the page, you must include: <font color=red><nowiki>==Notes== <references/> </nowiki></font> | ##Each individual reference needs <font color="red"><nowiki><ref></nowiki></font> before and <font color="red"><nowiki></ref></nowiki></font> afterwards | ||
##And, at the very bottom of the page, you must include: <font color="red"><nowiki>==Notes== <references/> </nowiki></font> | |||
Here's an example: | Here's an example: | ||
<blockquote> | <blockquote> | ||
<tt> | <tt> | ||
According to scientists, the Sun is pretty big.<font color=red>'''<ref>'''E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23-5.'''</ref>'''<br/></font> | According to scientists, the Sun is pretty big.<font color="red">'''<ref>'''E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23-5.'''</ref>'''<br /></font> | ||
The Moon, however, is not so big.<font color=red>'''<ref>'''R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44-6.'''</ref>'''<br/></font> | The Moon, however, is not so big.<font color="red">'''<ref>'''R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44-6.'''</ref>'''<br /></font> | ||
<br/> | <br /> | ||
==Notes== | ==Notes== | ||
<br/> | <br /> | ||
<font color=red>'''<references/></font> | <font color="red">'''<references/>'''</font> | ||
</tt> | </tt> | ||
</blockquote> | </blockquote> | ||
Line 37: | Line 91: | ||
===An Example Template=== | ===An Example Template=== | ||
<pre> | <pre> | ||
<!-- cut and paste the following template into a word file, | <!-- cut and paste the following [[template]] into a word file, | ||
replace any text with your desired text, leave all symbols--> | replace any text with your desired text, leave all symbols--> | ||
Line 64: | Line 118: | ||
<references/>” | <references/>” | ||
</pre> | </pre> | ||
==How to Add A Picture== | |||
#Upload the picture here: [[Special:Upload]] | |||
#Go to the page you want to add a picture and click the picture icon (fifth icon) and follow instructions. OR type in <pre>[[Image:filename.png|right|200px]]</pre> where filename is replaced by the correct filename, right is the side of the page the image should appear, and 200 is the picture width. | |||
==How to Change Page Titles== | |||
#Go to the page you desire to change the title. | |||
#Click on the "Move" tab that is found in the dropdown menu next to read, edit, and view history. | |||
#Choose a new name and click "Move Page". You're done. | |||
#To ensure that the redirects aren't messed up, check here and fix accordingly: [[Special:DoubleRedirects]] | |||
==Transliteration from Hebrew to English== | |||
We hope to offer a dynamic interface that allows the user to choose his transliteration or pronunciation style (Ashkenazic, Sephardic) and the text will appear accordingly. However, until we can implement this feature this is what we have:<br> | |||
This issue is troublesome because there is no universally-accepted method. For a brief introduction to the topic there is an article in wikipedia called [http://en.wikipedia.org/wiki/Romanization_of_hebrew Romanization of Hebrew]. Of the various options, we have chosen to use the "Common Israeli" version, except that the 8th Hebrew letter should be denoted by 'ch'. While this represents the official recommendation of the site, we realize that there are often numerous variations in spelling, some more common than others. We hope to list such spellings at the bottom of the given synonymous page, and to create a redirect page accordingly, and we encourage your help in this regard. | |||
[[File:alefbet.png|400px]] | |||
[[File:hebrewvowels.png|150px]] | |||
==Capitalizing Titles== | |||
Halachipedia adopts the "Title case" for its style of capitalizing page and section titles. The rules of "Title case" are as follows: | |||
*Capitalize the first and last word in a title, regardless of part of speech | |||
*Capitalize all nouns (baby, country, picture), pronouns (you, she, it, which), verbs (walk, think, dream), adjectives (sweet, large, perfect), adverbs (immediately, quietly), and subordinating conjunctions (as, because, although) | |||
*Lowercase all articles (a, the), prepositions (to, of, at, in, with, on, during, into), and coordinating conjunctions (for, and, nor, but, or, yet, and so) | |||
*Lowercase “to” as part of an infinitive. | |||
*"That" should be capitalized whether it is used as a pronoun (referring to a person, place, or thing, such as "''that'' is the halacha"), relative pronoun (beginning a subordinate clause that shares an argument with the main clause, such as "[[Melacha That Begins Before Shabbat]]"), or a subordinating conjunction (introducing clause about the subject, such as "the halacha is ''that'' it is permitted"). | |||
#For example: How to Edit Halachipedia (all words capitalized except “to,” which is part of an infinitive). <br>See [http://www.dailywritingtips.com/rules-for-capitalization-in-titles/ Dailywritingtips.com for details.] | |||
#For example: "Telling a Non-Jew on [[Shabbat]] to Work After [[Shabbat]]" all words are capitalized except for: a (article), on (preposition), and to (infinitive). | |||
==Capitalizing Hebrew Words== | |||
In general, the capitalization depends on whatever would be capitalized in English. | |||
#Rule 1: The first word of a sentence is always capitalized | |||
#Rule 2: A proper noun is capitalized. A proper noun is a name for an specific person, place, or organization. | |||
##For example, Shabbat is a proper noun just like Saturday would be and should be capitalized. However, a bracha should be lowercase just like a blessing is a noun and is lowercase, though, Birchot HaTorah would be capitalized for that matter. | |||
##Another example, is that the word 'rishonim' (Medeval commentators) shouldn't be capitalized, but Tosfot should be since it refers to a specific group of French rabbis living in the Twelfth century. | |||
==Page Classification== | |||
To maintain organization for the development of Halachipedia's content, there is a ranking system of pages. Every content page should fall into one of the following categories: | |||
#Stub - The page has less than 3 halacha's. | |||
#Lacking - The page has anywhere from 3 to 10 halacha's. | |||
#Okay - The page still can be improved significantly. Either it lacks content depending on the topic, it lacks structure, or needs updating. | |||
#Good - The page can still be improved. It can have more content, pictures, or organization. | |||
#Done - The page is a finished product. It can only be edited by administrators. | |||
The five classifications will look as follows: | |||
{{Stub}} | |||
{{Lacking}} | |||
{{Okay}} | |||
{{Good}} | |||
{{Done}} | |||
To implement this classification, simply put one of the following lines at the top of a page of content: <nowiki>{{Stub}}, {{Lacking}}, {{Okay}}, {{Good}}, {{Done}}</nowiki><br> | |||
Please help us implement this classification system. We can utilize this classification to devote our attention to the pages which need the most help, by seeing the following lists: | |||
#[[Special:WhatLinksHere/Template:Stub]] | |||
#[[Special:WhatLinksHere/Template:Lacking]] | |||
#[[Special:WhatLinksHere/Template:Okay]] | |||
#[[Special:WhatLinksHere/Template:Good]] | |||
#[[Special:WhatLinksHere/Template:Done]] | |||
==Overlapping Content== | |||
If content is relevant to two separate pages, our goal is to make the content available to users whichever page they are reading. If one of the pages is the primary one and the other is secondary, the content should be written on the primary page and the secondary one should just have a reference to the primary page. On the other hand, if the halacha is very relevant to both pages, it should be included on both pages. However, the pages should be coordinated so that changes on one page also appear on the other. The current solution is to use templates. To do this, create a [[template]] and insert the halacha and the relevant footnotes into the [[template]]. Then include the [[template]] wherever it belongs. with <nowiki>{{template_name}}</nowiki> <br> | |||
For example, see the [[template]] for Writings on the Side of Pages: [[Template:Writing_on_the_Side_of_Books]]. Here are the pages where it is included: | |||
*[[Kotaiv]] | |||
*[[Mochek]] | |||
*[[Books, notebooks, and papers]] | |||
==Other Templates== | |||
===Incomplete Sections=== | |||
To indicate that only a section is lacking use: <nowiki>{{SectionLacking}}</nowiki>. This is displayed as follows: | |||
{{SectionLacking}} | |||
===Missing Source=== | |||
If a halacha is missing a source, it should be marked clearly so that it can be corrected or removed quickly. It is included with the following code:<nowiki>{{NoSource}}</nowiki> and it displays as follows:<br /> | |||
{{NoSource}} | |||
===Questionable Page=== | |||
Use this [[template]] if a page has very questionable content or a topic that does not belong on Halachipedia. | |||
It is included with <nowiki>{{QuestionablePage}}</nowiki> and it displays as follows:<br /> | |||
{{QuestionablePage}} | |||
===Ibid in Sources=== | |||
Ibid is discouraged because of the inflexibility it causes to the growing site. This [[template]] is included with the following: <nowiki>{{Ibid}}</nowiki> and it displays as follows: | |||
{{Ibid}} | |||
===Reference Columns=== | |||
Pages that have a lot of sources could look nicer with 2 column or 3 columns. This is currently implemented on the [[Tefillin]] page and [[Chol HaMoed]] page. It is included by replacing <nowiki><references/> with {{Reflist|2}} or {{Reflist|3}}.</nowiki><br> | |||
Currently, we're using reference highlights with a little CSS to make it easier to find which footnote you are up to. See the [[Mediawiki:Vector.css]] page for that code. | |||
==How to Categorize a Page== | |||
The categorization system is very useful for organizational purposes. At the bottom of every page should be a category link. All you have to do is add the following at the bottom of a page: <nowiki>[[Category:Category_Name]]</nowiki>.<br> | |||
The next question is how to create a Category. Simple. | |||
*Go to the following URL: | |||
*Click the Create Tab (top right) | |||
*Type <nowiki>{{cat main}}</nowiki> | |||
*Save page. Done. | |||
Here's an example of a Category page: | |||
[[Category:Chanukah]] | |||
. | |||
==Get Halachipedia Offline== | |||
#See [[Get Halachipedia Offline]] | |||
==Links for More Coding Help== | ==Links for More Coding Help== | ||
* [http://www.mediawiki.org/wiki/Help:Formatting Wiki | |||
*[http://en.wikipedia.org/wiki/Help:Cheatsheet Wiki Markup Cheatsheet] | |||
*[http://www.mediawiki.org/wiki/Help:Formatting Wiki Formatting Help Page] |
Latest revision as of 22:14, 6 April 2022
How to Edit
Step 1: Become a user
|
Step 2: Learn how to edit
|
Halachipedia Training
Every edit or contribution you do makes a tremendous difference for the site as a whole and benefits people all over the world all the time. Yashar Koach or Chazak Ubaruch!
Editing with Visual Editor or Edit Source
|
Editing Style: Parts of the Halachipedia Page
|
Editing Style: Closer Look at Halachipedia Footnotes
|
How to Create a New Page
Enter the name to create a new page: |
- Unlike most websites whereby you create a new page and subsequently connect the new page to the main site via a link, in a wiki you first have to create the link and then the page. When you create the link, it will be to a blank page. Then when you click on this blank page, it will give you the option of adding content, so that it’s no longer blank.
- Therefore, the first thing to do is decide where your halachik article would belong within our topical categories as displayed on the left sidebar.
- For instance, “The Laws of Shema” would fall within the “Prayer” category.
- Next, you need to create the link. To do this, click the edit tab towards the top of the page. From here you’ll see a large editable text box with all sorts of strange looking coding symbols. Find where you should add your link and surround the title with double brackets
- For instance [[Laws of Shema]] = Laws of Shema
- A red link means that it's an empty page, which you can then click on and add content
How to Add Content
- To make a simple page, there are really only a few codes you should know
- Subtopics have == before and after ==
- Bullet points use the asterisk sign *
- Numbers use the pound sign #
- References require two things:
- Each individual reference needs <ref> before and </ref> afterwards
- And, at the very bottom of the page, you must include: ==Notes== <references/>
Here's an example:
According to scientists, the Sun is pretty big.<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>
The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>
==Notes==
<references/>
An Example Template
<!-- cut and paste the following [[template]] into a word file, replace any text with your desired text, leave all symbols--> Write a two sentence introduction-just replace this text with your introduction. <!--Use the next line of code if you want to insert an image, else erase --> [[File:name of image file.jpg|thumb|right|''text you want below image'' ]] == Replace this text with First Section title == # Replace with desired text <ref> Replace with desired reference</ref> # Replace with desired next point text<ref> Replace with desired reference</ref> # Replace with desired next point text<ref> Replace with desired reference</ref> == Next Section Title == # text <ref>reference</ref> # next point text<ref> reference</ref> # next point text<ref> reference</ref> == Next Section Title == # text <ref>reference</ref> # next point text<ref> reference</ref> # next point text<ref> reference</ref> <!--Do not erase the next two lines --> ==Sources== <references/>”
How to Add A Picture
- Upload the picture here: Special:Upload
- Go to the page you want to add a picture and click the picture icon (fifth icon) and follow instructions. OR type in
[[Image:filename.png|right|200px]]
where filename is replaced by the correct filename, right is the side of the page the image should appear, and 200 is the picture width.
How to Change Page Titles
- Go to the page you desire to change the title.
- Click on the "Move" tab that is found in the dropdown menu next to read, edit, and view history.
- Choose a new name and click "Move Page". You're done.
- To ensure that the redirects aren't messed up, check here and fix accordingly: Special:DoubleRedirects
Transliteration from Hebrew to English
We hope to offer a dynamic interface that allows the user to choose his transliteration or pronunciation style (Ashkenazic, Sephardic) and the text will appear accordingly. However, until we can implement this feature this is what we have:
This issue is troublesome because there is no universally-accepted method. For a brief introduction to the topic there is an article in wikipedia called Romanization of Hebrew. Of the various options, we have chosen to use the "Common Israeli" version, except that the 8th Hebrew letter should be denoted by 'ch'. While this represents the official recommendation of the site, we realize that there are often numerous variations in spelling, some more common than others. We hope to list such spellings at the bottom of the given synonymous page, and to create a redirect page accordingly, and we encourage your help in this regard.
Capitalizing Titles
Halachipedia adopts the "Title case" for its style of capitalizing page and section titles. The rules of "Title case" are as follows:
- Capitalize the first and last word in a title, regardless of part of speech
- Capitalize all nouns (baby, country, picture), pronouns (you, she, it, which), verbs (walk, think, dream), adjectives (sweet, large, perfect), adverbs (immediately, quietly), and subordinating conjunctions (as, because, although)
- Lowercase all articles (a, the), prepositions (to, of, at, in, with, on, during, into), and coordinating conjunctions (for, and, nor, but, or, yet, and so)
- Lowercase “to” as part of an infinitive.
- "That" should be capitalized whether it is used as a pronoun (referring to a person, place, or thing, such as "that is the halacha"), relative pronoun (beginning a subordinate clause that shares an argument with the main clause, such as "Melacha That Begins Before Shabbat"), or a subordinating conjunction (introducing clause about the subject, such as "the halacha is that it is permitted").
- For example: How to Edit Halachipedia (all words capitalized except “to,” which is part of an infinitive).
See Dailywritingtips.com for details. - For example: "Telling a Non-Jew on Shabbat to Work After Shabbat" all words are capitalized except for: a (article), on (preposition), and to (infinitive).
Capitalizing Hebrew Words
In general, the capitalization depends on whatever would be capitalized in English.
- Rule 1: The first word of a sentence is always capitalized
- Rule 2: A proper noun is capitalized. A proper noun is a name for an specific person, place, or organization.
- For example, Shabbat is a proper noun just like Saturday would be and should be capitalized. However, a bracha should be lowercase just like a blessing is a noun and is lowercase, though, Birchot HaTorah would be capitalized for that matter.
- Another example, is that the word 'rishonim' (Medeval commentators) shouldn't be capitalized, but Tosfot should be since it refers to a specific group of French rabbis living in the Twelfth century.
Page Classification
To maintain organization for the development of Halachipedia's content, there is a ranking system of pages. Every content page should fall into one of the following categories:
- Stub - The page has less than 3 halacha's.
- Lacking - The page has anywhere from 3 to 10 halacha's.
- Okay - The page still can be improved significantly. Either it lacks content depending on the topic, it lacks structure, or needs updating.
- Good - The page can still be improved. It can have more content, pictures, or organization.
- Done - The page is a finished product. It can only be edited by administrators.
The five classifications will look as follows:
This article is a stub. |
This article is lacking content. |
This article is okay. |
This article is good. |
This article is complete. |
To implement this classification, simply put one of the following lines at the top of a page of content: {{Stub}}, {{Lacking}}, {{Okay}}, {{Good}}, {{Done}}
Please help us implement this classification system. We can utilize this classification to devote our attention to the pages which need the most help, by seeing the following lists:
- Special:WhatLinksHere/Template:Stub
- Special:WhatLinksHere/Template:Lacking
- Special:WhatLinksHere/Template:Okay
- Special:WhatLinksHere/Template:Good
- Special:WhatLinksHere/Template:Done
Overlapping Content
If content is relevant to two separate pages, our goal is to make the content available to users whichever page they are reading. If one of the pages is the primary one and the other is secondary, the content should be written on the primary page and the secondary one should just have a reference to the primary page. On the other hand, if the halacha is very relevant to both pages, it should be included on both pages. However, the pages should be coordinated so that changes on one page also appear on the other. The current solution is to use templates. To do this, create a template and insert the halacha and the relevant footnotes into the template. Then include the template wherever it belongs. with {{template_name}}
For example, see the template for Writings on the Side of Pages: Template:Writing_on_the_Side_of_Books. Here are the pages where it is included:
Other Templates
Incomplete Sections
To indicate that only a section is lacking use: {{SectionLacking}}. This is displayed as follows:
This article section is a stub. |
Missing Source
If a halacha is missing a source, it should be marked clearly so that it can be corrected or removed quickly. It is included with the following code:{{NoSource}} and it displays as follows:
EVERY HALACHA ON HALACHIPEDIA STRICTLY REQUIRES A SOURCE. PLEASE ADD SOURCE HERE, OTHERWISE THIS HALACHA WILL BE REMOVED.
Questionable Page
Use this template if a page has very questionable content or a topic that does not belong on Halachipedia.
It is included with {{QuestionablePage}} and it displays as follows:
Until legitimate sources have been added for each halacha, please note that the halacha's without sources on this page may be questionable.
Ibid in Sources
Ibid is discouraged because of the inflexibility it causes to the growing site. This template is included with the following: {{Ibid}} and it displays as follows: Ibid
Reference Columns
Pages that have a lot of sources could look nicer with 2 column or 3 columns. This is currently implemented on the Tefillin page and Chol HaMoed page. It is included by replacing <references/> with {{Reflist|2}} or {{Reflist|3}}.
Currently, we're using reference highlights with a little CSS to make it easier to find which footnote you are up to. See the Mediawiki:Vector.css page for that code.
How to Categorize a Page
The categorization system is very useful for organizational purposes. At the bottom of every page should be a category link. All you have to do is add the following at the bottom of a page: [[Category:Category_Name]].
The next question is how to create a Category. Simple.
- Go to the following URL:
- Click the Create Tab (top right)
- Type {{cat main}}
- Save page. Done.
Here's an example of a Category page: .