Editing Guide: Difference between revisions

From creative crowd wiki
Jump to navigation Jump to search
No edit summary
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Newsletter sprint==
__TOC__


Some practical notes for the newsletter sprint during the workshop:
==Getting started==


===Editing technical specifications===
===Make an account===


* '''images''': at least 1000px wide, keep in mind that we will print in one color
At the top right of this page, click on "Create Account".
* '''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===
Enter a username and unique password, and then confirm the password. You can enter your real name if you like, but it is not strictly necessary to make an account.


* '''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.
Then, the CAPTCHA question asked you in which city the Varia server is hosted?
* '''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===
Then, click "Create your account".


* '''Timezone settings of the wiki''': under <code>Preferences > Appearance > Time offset</code>
===Making a new page===
 
==Peer-annotations==
 
We will work with peer-annotations using embedded etherpads.
 
To enable peer-annotations:


1. '''Copy this line of code to the writing area:'''
https://www.mediawiki.org/wiki/Help:Starting_a_new_page


<nowiki><div class="pad"><eplite id="CHANGEME" show-chat="false" /></div></nowiki>
* 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.


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


For example into the title of your contribution.  
https://www.mediawiki.org/wiki/Help:Moving_a_page


<span style="color:magenta;">NOTE: You cannot use spaces in the id="" value.</span>
* MediaWiki counter-intuitively calls this "move page". With this logic, "moving" a page is the same as renaming it.


3. '''Scroll down and click "Save page" to save the page.'''
==Editing a page==


4. '''The etherpad should appear on the right side of the screen.'''
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==
Below you can find a '''cheatsheet''' with commonly used wikitext mark up, accompanied with a few '''remarks''' on quirks we discovered while working with wiki-to-print.


To edit a page, you can use the '''visual editor''' or the '''wiki syntax editor'''.
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===
===Visual editor===
Line 57: Line 39:
* [https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide Visual editor user guide]
* [https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide Visual editor user guide]


===Wiki syntax editor===
===Wikitext editor===


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


==Categories==
==Cheatsheet + remarks==
<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:
===Headers===


<nowiki>[[Category:Toward a Minor Tech]]</nowiki>
https://www.mediawiki.org/wiki/Help:Formatting
 
* 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.)
 
===Images===
 
https://www.mediawiki.org/wiki/Help:Images
 
* 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 '''wikitext''': 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>.
 
===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 <code>*</code> symbol at the start of each line.


===1000 words===
===Footnotes===


If you work on your 1000 words version (the preliminary text for the workshop), please include the following category assigner in your page:  
https://www.mediawiki.org/wiki/Help:Cite


<nowiki>[[Category:1000 words]]</nowiki>
===Quotes===


===500 words===
* 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.


If you work on your 500 words version (shorter version as part of the workshop), please include the following category assigner in your page:
===Categories===


<nowiki>[[Category:500 words]]</nowiki>
https://www.mediawiki.org/wiki/Help:Categories


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


If you work on your 5000 words version (for the online journal APRJA), please include the following category assigner in your page:  
<nowiki>[[Category:Toward a Minor Tech]]</nowiki>


<nowiki>[[Category:5000 words]]</nowiki>
* Often these category assigners are placed at the bottom of a page.


==Skins==
==Skins==
Line 102: Line 108:


<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>
[[Category:Wiki-to-print]]

Latest revision as of 11:02, 4 April 2024

Getting started

Make an account

At the top right of this page, click on "Create Account".

Enter a username and unique password, and then confirm the password. You can enter your real name if you like, but it is not strictly necessary to make an account.

Then, the CAPTCHA question asked you in which city the Varia server is hosted?

Then, click "Create your account".

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". With this logic, "moving" a page is the same as renaming it.

Editing a page

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 on 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

Wikitext editor

Cheatsheet + remarks

Headers

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

  • 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 wikitext: 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.

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
Retrieved from "http://cc.vvvvvvaria.org/wiki/index.php?title=Editing_Guide&oldid=3737"