Difference between revisions of "Publisher:Style-guide"

From Publication Station
 
 
(6 intermediate revisions by one other user not shown)
Line 2: Line 2:


== General Document Formatting==
== General Document Formatting==
Text submissions should be sent preferably in '''.docx''' '''Markdown''' or '''Mediawiki syntax'''(if writing on a wiki).
Text submissions should be received as '''.docx''' , '''Markdown''' or '''Mediawiki syntax''' (if writing on a wiki).


Most of what follows is specific .docx, yet the same text structure and hierarchy applies to Markdown or Mediawiki.  
Most of what follows is specific to .docx, yet the same text structure and hierarchy applies to Markdown or Mediawiki.  


'''It is fundamental to format the text using Word/LibreOffice Styles''' . (See [https://support.office.com/en-nz/article/Style-basics-in-Word-d382f84d-5c38-4444-98a5-9cbb6ede1ba4 Style basics in Word tutorial] or [https://help.libreoffice.org/Writer/Styles_in_Writer Styles in LibreOffice Writer tutorial] )
'''It is fundamental to format the text using Word/LibreOffice Styles''' . (See [https://support.office.com/en-nz/article/Style-basics-in-Word-d382f84d-5c38-4444-98a5-9cbb6ede1ba4 Style basics in Word tutorial] or [https://help.libreoffice.org/Writer/Styles_in_Writer Styles in LibreOffice Writer tutorial] )


* The '''whole text''' should have '''Normal''' style as default (normally this is the default when writing).
* The '''whole text''' should have '''Normal''' style as default (normally this is the default when writing).
* The '''Title''' should have '''Heading 1''' style
* The '''Author's name''' should have '''Normal''' style and be in a paragraph following the Title.
* The '''Author's name''' should have '''Normal''' style and be in a paragraph following the Title.
* Article's '''Title''' should have '''Header 1'''
* Article's '''Sections''' should have '''Header 2'''
* Article's '''Sections''' should have '''Header 2'''
* Article's '''Subsections''' should have '''Header 3''' style.
* Article's '''Subsections''' should have '''Header 3''' style.
Line 16: Line 17:
* '''Long quotes or Blockquotes''' are create by '''indenting the whole blockquote'''.
* '''Long quotes or Blockquotes''' are create by '''indenting the whole blockquote'''.


* '''Do not use tabs for paragraph breaks at any time but a white space (hard return) between paragraphs'''.
* '''Do not use tabs for paragraph breaks at any time, but a white space (hard return) between paragraphs'''.
* '''Do not use underlining at any time'''.
* Add ''italics'' where needed (for proper names (see specific formatting below) references, emphasis on single words).
* Add ''italics'' where needed (for proper names (see specific formatting below) references, emphasis on single words).
* Bold can be used, but NOT to create headings (emphasis on single words).
* Bold can be used, but NOT to create headings (emphasis on single words).
* Use single line-spacing.
* Aligned the text to the left.


== Specific Formatting==
== Specific Formatting==
* '''URLs must be complete'''. E.g. <nowiki>http://nu.nl/</nowiki> and '''not''' nu.nl or www.nu.nl
* '''URLs must be complete'''. E.g. <nowiki>http://nu.nl/</nowiki> and '''not''' nu.nl or www.nu.nl
* URLs should '''not''' be (Word/Libreoffice) clickable hyperlinks, but the plain and unclickable, in short '''not blue links'''.   
* URLs should '''not''' be (Word/Libreoffice) clickable hyperlinks, but the plain and unclickable, in short '''not blue links'''.   
* All headings and subtitles are '''capitalized'''. Capitalize the first word of the title, the last word of the title, and all nouns, pronouns, verbs, adverbs, adjectives. Do not capitalize prepositions or conjunctions unless contain more than 4 letters. E.g. Social Media Monopolies and Their Alternatives.
 
* Italicize (no quotation marks) proper names such as films, books, television series, works of art, etc. Song titles, for example, are placed between single quotation marks, while album titles are italicized.





Latest revision as of 09:04, 23 April 2019

Style Guide for Publication Station's publications

General Document Formatting

Text submissions should be received as .docx , Markdown or Mediawiki syntax (if writing on a wiki).

Most of what follows is specific to .docx, yet the same text structure and hierarchy applies to Markdown or Mediawiki.

It is fundamental to format the text using Word/LibreOffice Styles . (See Style basics in Word tutorial or Styles in LibreOffice Writer tutorial )

  • The whole text should have Normal style as default (normally this is the default when writing).
  • The Author's name should have Normal style and be in a paragraph following the Title.
  • Article's Title should have Header 1
  • Article's Sections should have Header 2
  • Article's Subsections should have Header 3 style.
  • Short quotations use single quotation marks.
  • Long quotes or Blockquotes are create by indenting the whole blockquote.
  • Do not use tabs for paragraph breaks at any time, but a white space (hard return) between paragraphs.
  • Add italics where needed (for proper names (see specific formatting below) references, emphasis on single words).
  • Bold can be used, but NOT to create headings (emphasis on single words).

Specific Formatting

  • URLs must be complete. E.g. http://nu.nl/ and not nu.nl or www.nu.nl
  • URLs should not be (Word/Libreoffice) clickable hyperlinks, but the plain and unclickable, in short not blue links.


Footnotes and referencing

  • All footnotes should be inserted by doing: Insert -> Footnote.

Andre (talk) 12:32, 14 April 2015 (CEST) ARE MS WORD FOOTNOTES INSERTED THAT SAME WAY?

  • Always put a period at the end of a footnote, even if it just a URL.
  • Footnote references, when in a vicinity of comma or period, should come after the comma or period.

This also applies, if the comma/period follows a quotation mark. I.e.: ‘an alternative network’.[1]

Specific for MS WORD

  • All references should be auto-inserted footnotes (in other words, no in text references that use parentheses/brackets). For example, not: Off the Press discusses the question of digital publishing (Lorusso, 2013). But: Off the Press discusses the question of digital publishing.[2]
  • All references should also be collected into a Reference list at the end of the article. Please do not use an automated reference list, or disable the macro after you finish making it this way.
  • URLs in footnotes should be clickable.
  • Always put a period at the end of a footnote, even if it just a URL (make sure the URL still works).


Andre (talk) 12:32, 14 April 2015 (CEST) TODO: Elaborate page on references' system

Quotations

As referred previously:

  • Long quotes or Blockquotes are create by indenting the whole blockquote.
  • All quotations should use single quotation marks except in instances of a quote inside a quote (in such cases use double quotation marks inside single quotation marks).
  • Commas and full stops should be placed after the quotation mark, if they’re not part of the quotation. E.g. 'My quotation will end here'.
  • If ellipsis are used in a quotation because the article’s author has removed or altered text, for example for the sentence to read grammatically correctly, be sure to put square brackets […] or [has] around the ellipsis to indicate this notation is made by the article's author and not the quoted author.

Images

  • WdKA's Publication Station takes no responsibility of the ownership of the images authors choose to use, the responsibility for the use of images is entirely authors.
  • Images can be in full color or black and white.
  • Images should be included in the text file at the right position as 72 dpi jpeg and, at the same time, sent separately as 300 dpi tiff (suitable for print). (The publication station will take responsibility for preparing the images for the text conversions)
  • Image files should be properly named and numbered according to their order of appearance in the text. E.g. Author_image1.jpg; Author_image2.png;
  • If an image includes a caption insert it by doing: Mouse right click -> "Caption...", Category = [None], Position = Below, insert the caption text. (Note to Publication Station: Images and captions disappear in Pandoc conversions. Therefore they need to be re-inserted mannualy).

Andre (talk) 12:32, 14 April 2015 (CEST) ARE MS WORD CAPITONS INSERTED THAT SAME WAY?


References

For Footnotes we advice you to use a Bibliography management system:

  • Zotero
  • LibreOffice / MS Word - Bibliography manager
  • Bibtex
  • ? How to convert to Bibtext ?
  • ? How to include Bibtext references in Pandoc conversions?

Andre (talk) 12:32, 14 April 2015 (CEST) TO DO - URGENT


  1. Footnote.
  2. Footnote.