Editing Guide: Difference between revisions

From creative crowd wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
==Newsletter sprint==


Some practical notes for the newsletter sprint during the workshop:
Editing can be done in many different ways, but we have found the following MediaWiki documentation useful: https://www.mediawiki.org/wiki/Help:Editing.


===Editing technical specifications===
Below you can find a '''cheatsheet''' with commonly used wikitext mark up, accompanied with a few '''remarks''' of quirks we discovered while working with wiki-to-print.


* '''images''': at least 1000px wide, keep in mind that we will print in one color
But first of all, it's good to know is that there are two editors that you can use to edit your text:  
* '''screenshots''': as big as you can
* '''captions''': if you have images, make sure they have captions. We suggest to use <code>frame</code> or <code>thumb</code> as image formats, these make the caption show up.
** In '''wiki syntax''': You can add the caption in the image element (<code><nowiki>[[File:Imagename.jpg|frame|caption here]]</nowiki></code>).
** In the '''visual editor''': click on the <code>image > edit > caption</code>.
* '''bibliography''': format it as you like, coherence is a forced illusion
* '''footnotes''': you can use <code><ref></code> system, see: https://www.mediawiki.org/wiki/Help:Cite
* '''title of your text''': use a header1 (<code>=Title here=</code>)
* '''other subtitles in your text''': use any ohter headers (header2 <code>==Title here==</code>, header3 <code>===Title here===</code>, etc.)
* '''quotes''': you can use <code><nowiki><blockquote>Your quote here</blockquote></nowiki></code>. Make sure this is separated from the body of your text with returns before and after the <code><nowiki><blockquote></nowiki></code> tags.


===We also need===
===Visual editor===
 
* to use it, click <code>Edit</code>
* uses a WYSIWYG editor
* [https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide Visual editor user guide]
 
===Wiki syntax editor===
 
* to use it, click <code>Edit source</code>
* uses a specific mark up language: wiki syntax
* [https://www.mediawiki.org/wiki/Help:Formatting Wiki syntax user guide]


* '''Contributors page (required)''': we are collecting information about all of us at [[Toward a Minor Tech:Contributors]]. Please leave something about each author there in max 32 words.
==Cheatsheet + remarks==
* '''Cellular contributions (optional)''': To make the newspaper we will work with a grid system, it's an endless Tetris game, so we anticipate that there will be empty cells in the newspaper. We're ''celling'' that space. ;) Anyone is invited to use this space for any convivial polyfill content [[Toward_a_Minor_Tech#Cellular_contributions|here]]. Limitations:
** for images: width 208px, height 144px (high res!)
** for text: 50 words


===Other links that can be useful===
MediaWiki uses "wikitext" to mark up text with '''bolds''' or ''italics'', and to headers, images, media, links, footnotes, tables, etc.


* '''Timezone settings of the wiki''': under <code>Preferences > Appearance > Time offset</code>
===Making a new page===
 
https://www.mediawiki.org/wiki/Help:Starting_a_new_page
 
* It might be easiest to search for the pagename that you want to create, and if it does not exist yet, then you can click on the red link to create that page.
 
===Renaming a page===
 
https://www.mediawiki.org/wiki/Help:Moving_a_page
 
* MediaWiki counter-intuitively calls this "move page"
 
===Headers===


==Peer-annotations==
* A header1 is written as: <code><nowiki>=Title here=</nowiki></code>
* Subtitles can be marked up as any other headers (header2 <code>==Title here==</code>, header3 <code>===Title here===</code>, etc.)


We will work with peer-annotations using embedded etherpads.
===Images===


To enable peer-annotations:
https://www.mediawiki.org/wiki/Help:Images


1. '''Copy this line of code to the writing area:'''
* If you have images, and you want to work with '''captions''', we suggest to use <code>frame</code> or <code>thumb</code> as image formats, these make the caption show up.
** In '''wiki syntax''': You can add the image width (in pixels) and caption in the image element (<code><nowiki>[[File:Imagename.jpg|thumb|480px|caption here]]</nowiki></code>).
** In the '''visual editor''': click on the <code>image > edit > caption</code>.


<nowiki><div class="pad"><eplite id="CHANGEME" show-chat="false" /></div></nowiki>
===Lists===


2. '''Change the id="" value from CHANGEME into an etherpad name of choice. '''
https://www.mediawiki.org/wiki/Help:Lists


For example into the title of your contribution.  
* Make sure that you add a line break before and after your list.


<span style="color:magenta;">NOTE: You cannot use spaces in the id="" value.</span>
===Links===


3. '''Scroll down and click "Save page" to save the page.'''
https://www.mediawiki.org/wiki/Help:Links


4. '''The etherpad should appear on the right side of the screen.'''
===Bibliography===


==Editing==
* We have used lists in the past to structure bibliographies, using the <code>*</code> symbol at the start of each line.


To edit a page, you can use the '''visual editor''' or the '''wiki syntax editor'''.
===Footnotes===


===Visual editor===
https://www.mediawiki.org/wiki/Help:Cite


* to use it, click <code>Edit</code>
===Quotes===
* uses a WYSIWYG editor
* [https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide Visual editor user guide]


===Wiki syntax editor===
* You can use <code><nowiki><blockquote>Your quote here</blockquote></nowiki></code>. Make sure this is separated from the body of your text with line breaks before and after the <code><nowiki><blockquote></nowiki></code> tags.


* to use it, click <code>Edit source</code>
===Categories===
* uses a specific mark up language: wiki syntax
* [https://www.mediawiki.org/wiki/Help:Formatting Wiki syntax user guide]


==Categories==
https://www.mediawiki.org/wiki/Help:Categories
<span style="color:magenta;">NOTE: It's recommended practice to add the category assigners at the bottom of your page.</span>


Add your page to the category Toward a Minor Tech, by including the following line in your page:
You can create categories or add your page to a category, by adding the following syntax to your page:


  <nowiki>[[Category:Toward a Minor Tech]]</nowiki>
  <nowiki>[[Category:Toward a Minor Tech]]</nowiki>


===1000 words===
* Often these category assigners are placed at the bottom of a page.
 
==Etherpads in the wiki==


If you work on your 1000 words version (the preliminary text for the workshop), please include the following category assigner in your page:
We installed an extension on the CC working that makes it possible to attach an etherpad to a wiki page.
During the making of Towards a Minor Tech, this feature was used used for peer-annotations during the writing process.


<nowiki>[[Category:1000 words]]</nowiki>
To add an etherpad to a wiki page:


===500 words===
1. '''Copy this line of code to the writing area:'''


If you work on your 500 words version (shorter version as part of the workshop), please include the following category assigner in your page:
<nowiki><div class="pad"><eplite id="CHANGEME" show-chat="false" /></div></nowiki>


<nowiki>[[Category:500 words]]</nowiki>
2. '''Change the id="" value from CHANGEME into an etherpad name of choice. '''


===5000 words===
For example into the title of your contribution.


If you work on your 5000 words version (for the online journal APRJA), please include the following category assigner in your page:
<span style="color:magenta;">NOTE: You cannot use spaces in the id="" value.</span>


<nowiki>[[Category:5000 words]]</nowiki>
3. '''Scroll down and click "Save page" to save the page.'''
 
4. '''The etherpad should appear on the right side of the screen.'''


==Skins==
==Skins==
Line 102: Line 114:


<span style="color:magenta;">NOTE: This does not change the skin for everyone. It only changes for your user account.</span>
<span style="color:magenta;">NOTE: This does not change the skin for everyone. It only changes for your user account.</span>
==Other links that can be useful==
* '''Timezone settings of the wiki''': under <code>Preferences > Appearance > Time offset</code>

Revision as of 13:08, 21 August 2023

Editing can be done in many different ways, but we have found the following MediaWiki documentation useful: https://www.mediawiki.org/wiki/Help:Editing.

Below you can find a cheatsheet with commonly used wikitext mark up, accompanied with a few remarks of quirks we discovered while working with wiki-to-print.

But first of all, it's good to know is that there are two editors that you can use to edit your text:

Visual editor

Wiki syntax editor

Cheatsheet + remarks

MediaWiki uses "wikitext" to mark up text with bolds or italics, and to headers, images, media, links, footnotes, tables, etc.

Making a new page

https://www.mediawiki.org/wiki/Help:Starting_a_new_page

  • It might be easiest to search for the pagename that you want to create, and if it does not exist yet, then you can click on the red link to create that page.

Renaming a page

https://www.mediawiki.org/wiki/Help:Moving_a_page

  • MediaWiki counter-intuitively calls this "move page"

Headers

  • A header1 is written as: =Title here=
  • Subtitles can be marked up as any other headers (header2 ==Title here==, header3 ===Title here===, etc.)

Images

https://www.mediawiki.org/wiki/Help:Images

  • If you have images, and you want to work with captions, we suggest to use frame or thumb as image formats, these make the caption show up.
    • In wiki syntax: You can add the image width (in pixels) and caption in the image element ([[File:Imagename.jpg|thumb|480px|caption here]]).
    • In the visual editor: click on the image > edit > caption.

Lists

https://www.mediawiki.org/wiki/Help:Lists

  • Make sure that you add a line break before and after your list.

Links

https://www.mediawiki.org/wiki/Help:Links

Bibliography

  • We have used lists in the past to structure bibliographies, using the * symbol at the start of each line.

Footnotes

https://www.mediawiki.org/wiki/Help:Cite

Quotes

  • You can use <blockquote>Your quote here</blockquote>. Make sure this is separated from the body of your text with line breaks before and after the <blockquote> tags.

Categories

https://www.mediawiki.org/wiki/Help:Categories

You can create categories or add your page to a category, by adding the following syntax to your page:

[[Category:Toward a Minor Tech]]
  • Often these category assigners are placed at the bottom of a page.

Etherpads in the wiki

We installed an extension on the CC working that makes it possible to attach an etherpad to a wiki page. During the making of Towards a Minor Tech, this feature was used used for peer-annotations during the writing process.

To add an etherpad to a wiki page:

1. Copy this line of code to the writing area:

<div class="pad"><eplite id="CHANGEME" show-chat="false" /></div>

2. Change the id="" value from CHANGEME into an etherpad name of choice.

For example into the title of your contribution.

NOTE: You cannot use spaces in the id="" value.

3. Scroll down and click "Save page" to save the page.

4. The etherpad should appear on the right side of the screen.

Skins

The interface of MediaWiki's are called skins.

The default skin that is used on this wiki is Vector, but more skins are installed.

You can change the skin for yourself only, by following these steps:

  1. Click on Preferences in the right-top corner.
  2. Click on Appearance.
  3. Select a skin from the list.
  4. Click Save.

NOTE: This does not change the skin for everyone. It only changes for your user account.

Other links that can be useful

  • Timezone settings of the wiki: under Preferences > Appearance > Time offset