Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

ProleWiki:Editorial guidelines: Difference between revisions

From ProleWiki, the proletarian encyclopedia
No edit summary
Tag: Visual edit
mNo edit summary
Tag: Visual edit
 
(32 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Title|ProleWiki editorial guidelines}}We have editorial conventions that help maintain a consistent style throughout the whole wiki. This discusses mainly form, not content.
{{Title|ProleWiki editorial guidelines}}We have editorial conventions that help maintain a consistent style throughout the whole [[ProleWiki|wiki]]. These discuss mainly form, not content. The latter must follow ProleWiki's [[ProleWiki:Principles|principles]].


Don't forget that the best way to learn how we can maintain a consistent style is by looking at how other articles are built. You can suggest changes in the [[ProleWiki talk:Editorial conventions|discussion page]].
Don't forget that the best way to learn how we can maintain a consistent style is by looking at how [[Special:AllPages|other articles]] are built. You can suggest changes in the [[ProleWiki talk:Editorial conventions|discussion page]].
 
== Encyclopedic tone ==
We have started an [[ProleWiki:Encyclopedic tone guide|encyclopedic tone guide]] to help editors write professional and consistent language. We recommend you give it a read on top of these editorial guidelines.


==Content pages==
==Content pages==
ProleWiki currently does not favor any regional variant of English spelling, so do not make edits just to change spellings to a certain country's variants.
===Title===
===Title===
<ol style="list-style-type:upper-roman">
 
<li>Use preferably '''sentence case''' in the title of our articles except in the case for proper nouns (only the first word of a sentence and proper nouns are capitalized).
* Use '''sentence case''' in the title of our articles except in the case for proper nouns (only the first word of a sentence and proper nouns are capitalized).<blockquote class="toccolours">The economic basis of the withering away of the state ('''do''')<br>The Economic Basis of the Withering Away of the State ('''don't''')</blockquote>
<blockquote class="toccolours">The economic basis of the withering away of the state ('''do''')<br>The Economic Basis of the Withering Away of the State ('''don't''')</blockquote>
* For organizations, use the full official name and do not abbreviate. Organizations commonly known by a non-English name or abbreviation should use the English translation in the title ([[Islamic Resistance Movement]] instead of the Arabic acronym ''Hamas'').
<li>For countries, use the official state's name when titling a page. For example, our page is titled [[Russian Federation]], with ''Russia'' redirecting there as the Federation is the most current incarnation of what is called Russia. Likewise, ''China'' redirects to the [[People's Republic of China]].  
* Be as specific as needed. For instance, the ''Russian revolution'' can mean both the [[Russian revolution of 1905|1905 Russian bourgeois revolution]] or the [[Russian revolution of 1917|1917 Russian socialist revolution]]. In this case, a title which already disambiguates this difference is recommended.
<li>For persons, use the most common name using the Latin alphabet, but remaining in the original language. See for example [[Deng|Deng Xiaoping]] (pinyin), [[Maximilien de Robespierre]] (not the entire name but the most common one), [[Hồ Chí Minh]] (with Vietnamese diacritics), [[Muammar Gaddafi]] (common transliteration from the original Arabic). Create redirects as needed to cover all possible spellings you can think of.  
====Countries====
<li>Be as specific as needed. For instance, the ''Russian revolution'' can mean both the [[Russian revolution of 1905|1905 Russian bourgeois revolution]] and the [[Russian revolution of 1917|1917 Russian socialist revolution]]. In this case, a title which already disambiguates this difference is ideal.
For countries, use the official state's name when titling a page. For example, our page is titled [[Russian Federation]], with ''Russia'' redirecting there as the Federation is the most current incarnation of what is called Russia. Likewise, ''China'' redirects to the [[People's Republic of China]]. This applies to both sovereign states (countries) and divisions within a country.
</ol>
* For former countries and states, include the years it existed in parentheses after the official name and connect the years with an en dash (–), not a hyphen (-). For example, [[Union of Soviet Socialist Republics (1922–1991)]].
** If a country began and ended before the Common Era, use BCE only in the second year: [[Roman Republic (509–27 BCE)]]. If a country begin before the Common Era and ended during it, use BCE for the first year and CE for the second: [[Han dynasty (202 BCE–220 CE)]].
 
====People====
For people, use the most common name using the Latin alphabet, but remaining in the original language. See for example [[Deng|Deng Xiaoping]] (pinyin), [[Maximilien de Robespierre]] (not the entire name but the most common one), [[Hồ Chí Minh]] (with Vietnamese diacritics), [[Muammar Gaddafi]] (common transliteration from the original Arabic). Create redirects as needed to cover all possible spellings you can think of as well as alternate names.
* Transgender people should use their chosen names for the title and have a redirect from the dead name. The dead name should not be mentioned in the main page.
* Hungarian and Japanese names should be written in their native order, which puts the family name first and given name second like Chinese and Korean names do. Write [[Abe Shinzō]] instead of Shinzō Abe, for example.
* For monarchs, treat the dynasty name as their family name and add a regnal number in Roman numerals between their first and last name if necessary. For example, [[Elizabeth II Windsor]]. For Chinese emperors, the family name of dynasty members is usually different from the name of the dynasty they ruled. For example, all [[Qing dynasty (1636–1912)|Qing]] emperors had the clan name Aisin-Gioro, as in [[Aisin-Gioro Puyi]].
* For people commonly known by Anglicized names (most commonly monarchs), use the original language's name as in [[Nikolai II Romanov]] instead of Nicholas II Romanov.
* For non-royalty with feudal titles, do not include the rank in their name but do include the location after a preposition from the original language: for example, [[Otto von Bismarck|Otto ''von'' Bismarck]] (Bismarck is from the title Prince of Bismarck and is not a surname).


===Body===
===Body===
<ol style="list-style-type:upper-roman">
 
<li>In the introductory paragraph of an article, use '''bold''' for when the subject of the article is ''first'' mentioned. This ensures the subject of the article is cited more clearly.</ol>
==== Lead ====
<blockquote class="toccolours">
 
In the introductory paragraph (lead) of an article, use '''bold''' for when the subject of the article or any synonyms are ''first'' mentioned. This ensures the subject of the article is defined more clearly.<blockquote class="toccolours">
<div style="margin-bottom:0.25em; padding: 0;line-height: 1.3; border-bottom: 1px solid #a2a9b1;"><span style="font-size:1.5em;font-family: 'Linux Libertine','Georgia','Times',serif;">Historical materialism</span></div>
<div style="margin-bottom:0.25em; padding: 0;line-height: 1.3; border-bottom: 1px solid #a2a9b1;"><span style="font-size:1.5em;font-family: 'Linux Libertine','Georgia','Times',serif;">Historical materialism</span></div>
<p style="font-size:85%">From ProleWiki, the proletarian encyclopedia</p>
<p style="font-size:85%">From ProleWiki, the proletarian encyclopedia</p>
'''Historical materialism''' broadly refers to applying the philosophy of dialectical materialism to the study of social life.
'''Historical materialism''' broadly refers to applying the philosophy of dialectical materialism to the study of social life.
</blockquote>
</blockquote>If there are multiple names of the subject or acronyms, bold those too on their first mention. For people, begin with their full official name and put a more common name later if necessary. The official name does not have to be the same as the birth name or legal name. Put their lifespan in parentheses immediately after the first name listed if they are dead, or their birth date only if they are still alive.<blockquote class="toccolours">'''Vladimir Ilyich Ulyanov''' (22 April 1870 – 21 January 1924), better known as '''Vladimir Lenin'''...
 
'''Miguel Miguel Mario Díaz-Canel y Bermúdez''' (born 20 April 1960) ...</blockquote>


==== Bluelinking and redlinking ====
==== Bluelinking and redlinking ====
I. Bluelinking: Blue links made to other articles should be made only once, when they are ''first'' introduced in the article. This is to prevent readers from getting distracted by excessive use of blue links. Blue links can also be repeated inside infoboxes (appearing once in the infobox, and once in the body).
<small>(note how the second mention of Marxist-Leninist is not linked in the example)</small><blockquote class="toccolours">
ProleWiki is a [[Marxism–Leninism|Marxist–Leninist]] encyclopedia founded in September 2020 aiming to make information accessible to [[Revolution|revolutionaries]] and those who wish to study revolutionary theory. We stand for the principles of anti-imperialism and we aim to combat the liberal hegemony in Western society by presenting a Marxist-Leninist understanding of political economy.
</blockquote>II. Blue links should also strictly be made in body text, never in headings. This is for readability reasons and coherence.


III. External links '''should not''' be used in the main body. If you need to use an external link as reference, then use it as citation. You can also create an "External links" section and put external sources there.
* Bluelinking: Blue links made to other articles should be made only once, when they are ''first'' introduced in the article. This is to prevent readers from getting distracted by excessive use of blue links. Blue links can also be repeated inside infoboxes (appearing once in the infobox, and once in the body). <small>(Note how the second mention of Marxist-Leninist is not linked in the example)</small>
<blockquote class="toccolours">'''ProleWiki''' is a [[Marxism–Leninism|Marxist–Leninist]] encyclopedia founded in September 2020 aiming to make information accessible to [[Revolution|revolutionaries]] and those who wish to study revolutionary [[theory]]. We stand for the principles of [[anti-imperialism]] and we aim to combat the [[Liberalism|liberal]] hegemony in [[Imperial core|Western]] society by presenting a Marxist-Leninist understanding of [[political economy]].</blockquote>
* Blue links should also strictly be made in body text, never in headings. This is for readability reasons and coherence.
* Make sure links are specific enough and avoid linking to disambiguation pages. Linking to abbreviations is fine (for example, [[DPRK]] redirects to Democratic People's Republic of Korea), but generic links such as [[Red Scare]] or [[Russian revolution]] will not link to the intended page.
* External links '''should not''' be used in the main body. If you need to use an external link as reference, then use it as citation. You can also create an "External links" section at the bottom and put external sources there.
 
====In-text citations====
 
* Avoid placing a citation after a space<blockquote class="toccolours">Jeff Bezos is a parasite.<sup>[1]</sup> ('''do''')<br>Jeff Bezos is a parasite. <sup>[1]</sup> ('''don't''')</blockquote>


====Citations====
* Avoid placing a citation before punctuation<blockquote class="toccolours">Without revolutionary theory,<sup>[1]</sup> there can be no revolutionary movement.<sup>[2]</sup> ('''do''')<br>Without revolutionary theory<sup>[1]</sup>, there can be no revolutionary movement<sup>[2]</sup>. ('''don't''')</blockquote>
<ol style="list-style-type:upper-roman" start="1">
<li>Avoid placing a citation after a space</ol>
<blockquote class="toccolours">Jeff Bezos is a parasite.<sup>[1]</sup> ('''do''')<br>Jeff Bezos is a parasite. <sup>[1]</sup> ('''don't''')</blockquote>


<ol style="list-style-type:upper-roman" start="2">
==== Naming conventions ====
<li>Avoid placing a citation before punctuation</ol>
When referring to someone with an abbreviated name, generally use their surname; for example, when not using [[Friedrich Engels]]'s full name, say 'Engels' instead of 'Friedrich.' However, Vietnamese names are an exception and use the second (given) name. Mongolian names only have a patronymic or matronymic and then personal name with no surname, and Icelandic names have a given name and then patronymic. In both cases, the given name should be used.
<blockquote class="toccolours">Without revolutionary theory,<sup>[1]</sup> there can be no revolutionary movement.<sup>[2]</sup> ('''do''')<br>Without revolutionary theory<sup>[1]</sup>, there can be no revolutionary movement<sup>[2]</sup>. ('''don't''')</blockquote>


===References ===
===References ===
Use our [[Template:Citation|Citation template]] for books and scientific articles, and the [[Template:Web citation|Web citation template]] for material usually available online or periodicals, newspapers, etc. These options are available through Visual Editor.
Use our [[Template:Citation|citation template]] for books and scientific articles, and the [[Template:Web citation|web citation template]] for material usually available online or periodicals, newspapers, etc. There is a [[Template:Video citation|separate citation template]] for videos on [[YouTube]] or similar platforms. These options are available through Visual Editor.
 
=== Order of sections (headings) ===
The end of a page must always follow this order in its headings:<blockquote>See Also [links to other internal pages]


Further Reading [links to books or articles]
When citing a work that is in our library, you do not need to add a link under the URL section, although you may add extra links under the [[Marxists Internet Archive|MIA]], PDF, or Libgen parameters. The template will automatically link to the work in our library.


External Links [links to outside pages]
=== Order of final headings ===
The end of a page must always follow this order in its headings:<blockquote>
* See also [links to other internal pages]
* Further reading [links to books or articles in the library]
* External links [links to outside pages]
* Notes
* References </blockquote>


References</blockquote>
=== Content pages about library works ===
Content pages about works in ProleWiki's library should describe the work and contain the template [[Template:Message box/Availableinlibrary|<nowiki>{{message box/Availableinlibrary}}</nowiki>]]. They should not contain the full text of the work, which should be in the library page instead. Song lyrics should also be located to the library page and not the content page about the song.


==Library==
==Library==
It was decided that when importing library works, we will not remove sections from the source or edit sentences in other ways. However, it was decided that we are allowed to add a foreword of our own as well as our own footnotes (called annotations) like so:


* It was decided that when importing text, we will not be removing sections from it. However, it was decided that we are allowed to add a foreword of our own as well as footnotes like so:
===Library work infobox===
*All library works should contain the [[Template:Library work]]<nowiki> infobox (call it with two curly brackets {{ }} ). The infobox should include at least the work's </nowiki>'''title, author,''' '''publication''' '''year''' and the '''source''' (either link to PDF or text or "X publisher edition" if taken from paper copy). It will automatically retitle the page according to the first two parameters. Ideally, the infobox should use as many parameters as possible.


===Library work infobox===
==== Links ====
*Books should all contain the [[Template:Library work]]<nowiki> infobox (call it with two curly brackets {{ ). The infobox should include at least the work's </nowiki>'''title, author,''' '''publication''' '''year''' and the '''source''' (either link to PDF or text or "X publisher edition" if taken from paper copy). It will automatically retitle the page according to the first two parameters. Ideally, the infobox should use as many parameters as possible.
Like regular pages, link to a topic the first time it is mentioned in a library work.


=== Library foreword ===
=== Library foreword ===
Line 63: Line 86:
* Use the [[Template:Foreword]] and populate the parameters, it will create the heading itself as well as any necessary styling.
* Use the [[Template:Foreword]] and populate the parameters, it will create the heading itself as well as any necessary styling.
* Remember that your foreword represents ProleWiki as a whole.
* Remember that your foreword represents ProleWiki as a whole.
* If the original book also contained a foreword, put the original after the ProleWiki foreword.
=== Math ===
For library works that contain math or chemistry equations, go into the visual editor and find the options for these equations under the insert bar.
=== Library notes and annotations ===
* For notes or citations included in the original publication or source, add a basic citation (Ctrl+Shift+K) and set its group to the chapter number followed by a period or leave it blank for shorter works.<ref group="1.">Footnote from original text</ref>
* For new ProleWiki annotations, add a basic citation and put it in the '''ProleWiki X.''' group like this<ref group="ProleWiki 4.">Note added by ProleWiki</ref>
** Replace '''X''' with the chapter number. Where you want to start counting is up to you when importing a work.
* Preferably add ProleWiki annotations at the end of a paragraph.
* Use sparingly, only to add corrections or '''important''' context not provided in the foreword or original notes.
** Correcting typos and spelling errors does not require annotations, but if you are not sure, check your proposed corrections with the editorship. They may sometimes look like typos but are actually an accepted word or an alternative correct spelling.
* Editors without the [[ProleWiki:Trusted Editor Permissions|trusted role]] should confirm their footnotes with the trusted editors before saving them on a page.
* References list should be at the end of the chapter or the end of the text, as a subheading nested ''under'' the editor's notes, and called "ProleWiki annotations." Example:
'''<big>Notes (heading)</big>'''<references group="1." />'''ProleWiki annotations (subheading)'''<references group="ProleWiki 4." />
=== Modernization of texts ===
==== Spelling variations of proper nouns ====
If a library work contains an outdated spelling or Romanization of a place name or personal name, add the modern spelling in brackets afterwards:<blockquote>In December 1905 a [[Bolsheviks|Bolshevik]] Conference was held in Tammerfors [Tampere], [[Grand Duchy of Finland (1809–1917)|Finland]]. ([[Library:History of the Communist Party of the Soviet Union|''History of the Communist party of the Soviet Union'']])</blockquote>However, if the same spelling is used multiple times, only add the modern spelling the first time and leave it unchanged the other times:<blockquote>After [[Roman Ungern-Sternberg|Ungern]]'s defeat, the [[Republic of China|Chinese]] general [[Zhang Zuolin|Chang Tso-lin]] [Zhang Zuolin] endeavoured, with the help of [[Empire of Japan (1868–1947)|Japanese]] [[Imperialism|imperialists]], to throttle the [[Mongolian People's Revolution|people's revolution]] in [[Bogd Khanate of Mongolia (1911–1924)|Mongolia]] and bring the latter under his control. On July 1, 1921, a meeting organized by Chang Tso-lin was held in Mukden which was attended by representatives of the [[Feudalism|feudal]] [[nobility]] of [[Inner Mongolia Autonomous Region|Inner]] and Outer Mongolia. At the meeting plans were discussed for seizing Outer Mongolia; Chang Tso-lin made active preparations for a march on Urga [Örgöö]. (''[[Library:History of the Mongolian People's Republic|History of the Mongolian People's Republic]]'')</blockquote>
==== Units of measurement ====
If a library work contains non-metric units of measurement, add the metric equivalent in brackets afterwards. For example:<blockquote>It should be mentioned that in 1937 the [[Kolkhoz|collective farms]] alone (without the [[Sovkhoz|state farms]]) produced a marketable surplus of over 1,700,000,000 poods [28,000,000 tonnes] of grain, which was at least 400,000,000 poods [6,600,000 tonnes] more than the [[Landlord|landlords]], [[Kulak|kulaks]] and [[Peasantry|peasants]] together marketed in 1913. (''History of the Communist Party of the Soviet Union'')</blockquote>In this example, the pood is a traditional Slavic unit of weight equal to 16.38 kg. The conversion should have a similar number of significant figures to the original and should not be much more precise than the original statistic.
== Essays ==
[[ProleWiki:Essays|Essays]] have much less strict guidelines and can be organized in any way editors want as long as they follow our [[ProleWiki:Principles|principles]].
== Common mistakes ==
=== Dashes and hyphens ===
* Use - for hyphenated words using a prefix such as [[anarcho-communism]] and for subtraction or negative numbers in math.
* Use – for connecting numbers (including years) or for connecting full words (not prefixes) such as [[Marxism–Leninism]].
* Use — for a pause in a sentence or connecting groups of more than one word.
=== Forgetting to sort pages ===


=== Library annotations ===
* When creating a new page, make sure you sort it properly. Pages about individuals should be sorted based on their surname and then given (or chosen) name unless there is no surname. If this does not match the order in the title page, set the page to sort as ''surname'', ''forename.''<nowiki> In the source editor, add {{DEFAULTSORT:</nowiki>''surname'', ''forename''<nowiki>}} to the bottom of the page. In the visual editor, go to options --> categories and add this order under "Sort this page by default as."</nowiki>


* Add a "basic" citation (Ctrl+Shift+K), and put it in the '''ProleWiki''' group like so: <ref group="ProleWiki">Note 1</ref>
== See also ==
* Preferably add annotations at the end of a paragraph.
* Use sparingly, only to add corrections or '''important''' context.
* Editors without the trusted role should confirm their footnotes with the trusted editors before saving them on a page.
* References list should be at the end of the chapter or the end of the text, as a subheading nested ''under'' the editor's references, and called "ProleWiki annotations" . Example:


=== Notes (<-- subheading 1) ===
* [[ProleWiki:Code of conduct|ProleWiki's code of conduct]]
<nowiki>*</nowiki>editor's footnotes
* [[ProleWiki:Principles|ProleWiki's principles]]
* [[ProleWiki:Editor onboarding|Editor onboarding]]


==== ProleWiki annotations (<-- subheading 2) ====
<references group="ProleWiki" />
[[Category:Contribute to ProleWiki]]
[[Category:Contribute to ProleWiki]]

Latest revision as of 21:23, 16 September 2024

We have editorial conventions that help maintain a consistent style throughout the whole wiki. These discuss mainly form, not content. The latter must follow ProleWiki's principles.

Don't forget that the best way to learn how we can maintain a consistent style is by looking at how other articles are built. You can suggest changes in the discussion page.

Encyclopedic tone

We have started an encyclopedic tone guide to help editors write professional and consistent language. We recommend you give it a read on top of these editorial guidelines.

Content pages

ProleWiki currently does not favor any regional variant of English spelling, so do not make edits just to change spellings to a certain country's variants.

Title

  • Use sentence case in the title of our articles except in the case for proper nouns (only the first word of a sentence and proper nouns are capitalized).

    The economic basis of the withering away of the state (do)
    The Economic Basis of the Withering Away of the State (don't)

  • For organizations, use the full official name and do not abbreviate. Organizations commonly known by a non-English name or abbreviation should use the English translation in the title (Islamic Resistance Movement instead of the Arabic acronym Hamas).
  • Be as specific as needed. For instance, the Russian revolution can mean both the 1905 Russian bourgeois revolution or the 1917 Russian socialist revolution. In this case, a title which already disambiguates this difference is recommended.

Countries

For countries, use the official state's name when titling a page. For example, our page is titled Russian Federation, with Russia redirecting there as the Federation is the most current incarnation of what is called Russia. Likewise, China redirects to the People's Republic of China. This applies to both sovereign states (countries) and divisions within a country.

People

For people, use the most common name using the Latin alphabet, but remaining in the original language. See for example Deng Xiaoping (pinyin), Maximilien de Robespierre (not the entire name but the most common one), Hồ Chí Minh (with Vietnamese diacritics), Muammar Gaddafi (common transliteration from the original Arabic). Create redirects as needed to cover all possible spellings you can think of as well as alternate names.

  • Transgender people should use their chosen names for the title and have a redirect from the dead name. The dead name should not be mentioned in the main page.
  • Hungarian and Japanese names should be written in their native order, which puts the family name first and given name second like Chinese and Korean names do. Write Abe Shinzō instead of Shinzō Abe, for example.
  • For monarchs, treat the dynasty name as their family name and add a regnal number in Roman numerals between their first and last name if necessary. For example, Elizabeth II Windsor. For Chinese emperors, the family name of dynasty members is usually different from the name of the dynasty they ruled. For example, all Qing emperors had the clan name Aisin-Gioro, as in Aisin-Gioro Puyi.
  • For people commonly known by Anglicized names (most commonly monarchs), use the original language's name as in Nikolai II Romanov instead of Nicholas II Romanov.
  • For non-royalty with feudal titles, do not include the rank in their name but do include the location after a preposition from the original language: for example, Otto von Bismarck (Bismarck is from the title Prince of Bismarck and is not a surname).

Body

Lead

In the introductory paragraph (lead) of an article, use bold for when the subject of the article or any synonyms are first mentioned. This ensures the subject of the article is defined more clearly.

Historical materialism

From ProleWiki, the proletarian encyclopedia

Historical materialism broadly refers to applying the philosophy of dialectical materialism to the study of social life.

If there are multiple names of the subject or acronyms, bold those too on their first mention. For people, begin with their full official name and put a more common name later if necessary. The official name does not have to be the same as the birth name or legal name. Put their lifespan in parentheses immediately after the first name listed if they are dead, or their birth date only if they are still alive.

Vladimir Ilyich Ulyanov (22 April 1870 – 21 January 1924), better known as Vladimir Lenin... Miguel Miguel Mario Díaz-Canel y Bermúdez (born 20 April 1960) ...

Bluelinking and redlinking

  • Bluelinking: Blue links made to other articles should be made only once, when they are first introduced in the article. This is to prevent readers from getting distracted by excessive use of blue links. Blue links can also be repeated inside infoboxes (appearing once in the infobox, and once in the body). (Note how the second mention of Marxist-Leninist is not linked in the example)

ProleWiki is a Marxist–Leninist encyclopedia founded in September 2020 aiming to make information accessible to revolutionaries and those who wish to study revolutionary theory. We stand for the principles of anti-imperialism and we aim to combat the liberal hegemony in Western society by presenting a Marxist-Leninist understanding of political economy.

  • Blue links should also strictly be made in body text, never in headings. This is for readability reasons and coherence.
  • Make sure links are specific enough and avoid linking to disambiguation pages. Linking to abbreviations is fine (for example, DPRK redirects to Democratic People's Republic of Korea), but generic links such as Red Scare or Russian revolution will not link to the intended page.
  • External links should not be used in the main body. If you need to use an external link as reference, then use it as citation. You can also create an "External links" section at the bottom and put external sources there.

In-text citations

  • Avoid placing a citation after a space

    Jeff Bezos is a parasite.[1] (do)
    Jeff Bezos is a parasite. [1] (don't)

  • Avoid placing a citation before punctuation

    Without revolutionary theory,[1] there can be no revolutionary movement.[2] (do)
    Without revolutionary theory[1], there can be no revolutionary movement[2]. (don't)

Naming conventions

When referring to someone with an abbreviated name, generally use their surname; for example, when not using Friedrich Engels's full name, say 'Engels' instead of 'Friedrich.' However, Vietnamese names are an exception and use the second (given) name. Mongolian names only have a patronymic or matronymic and then personal name with no surname, and Icelandic names have a given name and then patronymic. In both cases, the given name should be used.

References

Use our citation template for books and scientific articles, and the web citation template for material usually available online or periodicals, newspapers, etc. There is a separate citation template for videos on YouTube or similar platforms. These options are available through Visual Editor.

When citing a work that is in our library, you do not need to add a link under the URL section, although you may add extra links under the MIA, PDF, or Libgen parameters. The template will automatically link to the work in our library.

Order of final headings

The end of a page must always follow this order in its headings:

  • See also [links to other internal pages]
  • Further reading [links to books or articles in the library]
  • External links [links to outside pages]
  • Notes
  • References

Content pages about library works

Content pages about works in ProleWiki's library should describe the work and contain the template {{message box/Availableinlibrary}}. They should not contain the full text of the work, which should be in the library page instead. Song lyrics should also be located to the library page and not the content page about the song.

Library

It was decided that when importing library works, we will not remove sections from the source or edit sentences in other ways. However, it was decided that we are allowed to add a foreword of our own as well as our own footnotes (called annotations) like so:

Library work infobox

  • All library works should contain the Template:Library work infobox (call it with two curly brackets {{ }} ). The infobox should include at least the work's title, author, publication year and the source (either link to PDF or text or "X publisher edition" if taken from paper copy). It will automatically retitle the page according to the first two parameters. Ideally, the infobox should use as many parameters as possible.

Links

Like regular pages, link to a topic the first time it is mentioned in a library work.

Library foreword

  • We can add our own foreword to contextualize the text, explain why the reader should read it, explain that we've added our own footnotes but have not removed anything from the text.
  • Use the Template:Foreword and populate the parameters, it will create the heading itself as well as any necessary styling.
  • Remember that your foreword represents ProleWiki as a whole.
  • If the original book also contained a foreword, put the original after the ProleWiki foreword.

Math

For library works that contain math or chemistry equations, go into the visual editor and find the options for these equations under the insert bar.

Library notes and annotations

  • For notes or citations included in the original publication or source, add a basic citation (Ctrl+Shift+K) and set its group to the chapter number followed by a period or leave it blank for shorter works.[1. 1]
  • For new ProleWiki annotations, add a basic citation and put it in the ProleWiki X. group like this[ProleWiki 4. 1]
    • Replace X with the chapter number. Where you want to start counting is up to you when importing a work.
  • Preferably add ProleWiki annotations at the end of a paragraph.
  • Use sparingly, only to add corrections or important context not provided in the foreword or original notes.
    • Correcting typos and spelling errors does not require annotations, but if you are not sure, check your proposed corrections with the editorship. They may sometimes look like typos but are actually an accepted word or an alternative correct spelling.
  • Editors without the trusted role should confirm their footnotes with the trusted editors before saving them on a page.
  • References list should be at the end of the chapter or the end of the text, as a subheading nested under the editor's notes, and called "ProleWiki annotations." Example:

Notes (heading)

  1. Footnote from original text

ProleWiki annotations (subheading)

  1. Note added by ProleWiki

Modernization of texts

Spelling variations of proper nouns

If a library work contains an outdated spelling or Romanization of a place name or personal name, add the modern spelling in brackets afterwards:

In December 1905 a Bolshevik Conference was held in Tammerfors [Tampere], Finland. (History of the Communist party of the Soviet Union)

However, if the same spelling is used multiple times, only add the modern spelling the first time and leave it unchanged the other times:

After Ungern's defeat, the Chinese general Chang Tso-lin [Zhang Zuolin] endeavoured, with the help of Japanese imperialists, to throttle the people's revolution in Mongolia and bring the latter under his control. On July 1, 1921, a meeting organized by Chang Tso-lin was held in Mukden which was attended by representatives of the feudal nobility of Inner and Outer Mongolia. At the meeting plans were discussed for seizing Outer Mongolia; Chang Tso-lin made active preparations for a march on Urga [Örgöö]. (History of the Mongolian People's Republic)

Units of measurement

If a library work contains non-metric units of measurement, add the metric equivalent in brackets afterwards. For example:

It should be mentioned that in 1937 the collective farms alone (without the state farms) produced a marketable surplus of over 1,700,000,000 poods [28,000,000 tonnes] of grain, which was at least 400,000,000 poods [6,600,000 tonnes] more than the landlords, kulaks and peasants together marketed in 1913. (History of the Communist Party of the Soviet Union)

In this example, the pood is a traditional Slavic unit of weight equal to 16.38 kg. The conversion should have a similar number of significant figures to the original and should not be much more precise than the original statistic.

Essays

Essays have much less strict guidelines and can be organized in any way editors want as long as they follow our principles.

Common mistakes

Dashes and hyphens

  • Use - for hyphenated words using a prefix such as anarcho-communism and for subtraction or negative numbers in math.
  • Use – for connecting numbers (including years) or for connecting full words (not prefixes) such as Marxism–Leninism.
  • Use — for a pause in a sentence or connecting groups of more than one word.

Forgetting to sort pages

  • When creating a new page, make sure you sort it properly. Pages about individuals should be sorted based on their surname and then given (or chosen) name unless there is no surname. If this does not match the order in the title page, set the page to sort as surname, forename. In the source editor, add {{DEFAULTSORT:surname, forename}} to the bottom of the page. In the visual editor, go to options --> categories and add this order under "Sort this page by default as."

See also