Toward a Minor Tech:Editing guide: Difference between revisions

From creative crowd wiki
Jump to navigation Jump to search
No edit summary
 
(28 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Newsletter sprint==
Some practical notes for the newsletter sprint during the workshop:
===Editing technical specifications===
* '''images''': at least 1000px wide, keep in mind that we will print in one color
* '''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===
* '''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.
* '''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===
* '''Timezone settings of the wiki''': under <code>Preferences > Appearance > Time offset</code>


==Peer-annotations==
==Peer-annotations==


We will work with peer-annotations using an embedded etherpad.
We will work with peer-annotations using embedded etherpads.


To enable peer-annotations:
To enable peer-annotations:


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


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


2. '''Change the id="" value from CHANGEME into an etherpad name of choice. '''  
2. '''Change the id="" value from CHANGEME into an etherpad name of choice. '''  
Line 14: Line 42:
For example into the title of your contribution.  
For example into the title of your contribution.  


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


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


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


==Editing==
==Editing==
Line 37: Line 65:


==Categories==
==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 adding the following line anywhere in your page:
Add your page to the category Toward a Minor Tech, by including the following line in your page:


  <nowiki>[[Category:Toward a Minor Tech]]</nowiki>
  <nowiki>[[Category:Toward a Minor Tech]]</nowiki>
Line 44: Line 73:
===1000 words===
===1000 words===


If you work on your 1000 words version, please include the following category assigner in your page:  
If you work on your 1000 words version (the preliminary text for the workshop), please include the following category assigner in your page:  


  <nowiki>[[Category:1000 words]]</nowiki>
  <nowiki>[[Category:1000 words]]</nowiki>
Line 50: Line 79:
===500 words===
===500 words===


If you work on your 2000 words version, please include the following category assigner in your page:  
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>[[Category:500 words]]</nowiki>
  <nowiki>[[Category:500 words]]</nowiki>
===5000 words===
If you work on your 5000 words version (for the online journal APRJA), please include the following category assigner in your page:
<nowiki>[[Category:5000 words]]</nowiki>
==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:
# Click on Preferences in the right-top corner.
# Click on Appearance.
# Select a skin from the list.
# Click Save.
<span style="color:magenta;">NOTE: This does not change the skin for everyone. It only changes for your user account.</span>

Latest revision as of 13:52, 20 June 2023

Newsletter sprint

Some practical notes for the newsletter sprint during the workshop:

Editing technical specifications

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

We also need

  • 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.
  • 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 here. Limitations:
    • for images: width 208px, height 144px (high res!)
    • for text: 50 words

Other links that can be useful

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

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:

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

Editing

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

Visual editor

Wiki syntax editor

Categories

NOTE: It's recommended practice to add the category assigners at the bottom of your page.

Add your page to the category Toward a Minor Tech, by including the following line in your page:

[[Category:Toward a Minor Tech]]

1000 words

If you work on your 1000 words version (the preliminary text for the workshop), please include the following category assigner in your page:

[[Category:1000 words]]

500 words

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

[[Category:500 words]]

5000 words

If you work on your 5000 words version (for the online journal APRJA), please include the following category assigner in your page:

[[Category:5000 words]]

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.