Difference between revisions of "TheMagPi Information for new volunteers"

From eLinux.org
Jump to: navigation, search
m
(Monaco)
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TheMagPiHeader}}
+
{{TheMagPiTeamHeader}}
 
+
 
+
* [[QuickStart_guide_for_new_volunteers|Quick start guide for New Volunteers]] - A quick start guide to help new volunteers get the information they need.
+
* [[Information_for_new_volunteers|Information for New Volunteers]] - A guide to help new volunteers familiarize themselves with the team’s workflow.
+
* [[RPi_MagPi_InfoForAuthors|Information for authors]] - the process of submitting an article.
+
* [[TheMagPiLayout|Layout & fonts]] - description of the standard layout and associated fonts.
+
* [[TheMagPiPdf|PDF creation]] - instructions for the generation of PDF for electronic and paper publication.
+
  
  
Line 17: Line 10:
 
From the MagPi website:
 
From the MagPi website:
  
<blockquote>Mission Statement<br />
+
<blockquote>'''What we make'''<br /><br />
What we make
+
We produce a magazine with the intent to help and offer advice to users of the Raspberry Pi. This started out as a simple idea on the well known forums, with a few of us getting together and deciding on a loose outline of what we wanted to achieve. <br /><br />
  
We produce a magazine with the intent to help and offer advice to users of the Raspberry Pi. This started out as a simple idea on the well known forums, with a few of us getting together and deciding on a loose outline of what we wanted to achieve.
+
Over time many have joined and left the team, each bringing their own contribution and ideas to the final piece.<br /><br />
  
Over time many have joined and left the team, each bringing their own contribution and ideas to the final piece.
+
If you had asked us six months ago whether we thought the magazine would be half a year down the line, we would not have been sure. We are now able to offer printed copies, competitions, our own branded Raspberry Pi case, and stable mirrors on a website not entirely made in flash. <br /><br />
  
If you had asked us six months ago whether we thought the magazine would be half a year down the line, we would not have been sure. We are now able to offer printed copies, competitions, our own branded Raspberry Pi case, and stable mirrors on a website not entirely made in flash. Where does the money go?
+
'''Where does the money go?'''<br /><br />
  
We all started out as volunteers - we are certainly not in this for the money. However, there are certain administrative costs that go toward producing a reliable magazine, and printing magazines is certainly not free. We get a small amount of money from every copy sold - and this goes towards funding the entire production team. We also hope to be able to offer more competitions, and better product testing.<br />
+
We all started out as volunteers - we are certainly not in this for the money. However, there are certain administrative costs that go toward producing a reliable magazine, and printing magazines is certainly not free. We get a small amount of money from every copy sold - and this goes towards funding the entire production team. We also hope to be able to offer more competitions, and better product testing.<br /><br />
You can help
+
  
Any donation is very gratefully received. However, you don’t have to put money into this to help us along - time is also one of our limiting factors. If you think you can be of any use in the general production, drop us an email. The future
+
'''You can help'''<br /><br />
  
We had no idea how successful the magazine would be. Give us another six months, and there should be some real progress made. We are forever receiving requests for more formats, and this is definitely something we are looking into. Translations to other languages would be another great step.
+
Any donation is very gratefully received. However, you don’t have to put money into this to help us along - time is also one of our limiting factors. If you think you can be of any use in the general production, drop us an email. <br /><br />
 +
 
 +
'''The future'''<br /><br />
 +
 
 +
We had no idea how successful the magazine would be. Give us another six months, and there should be some real progress made. We are forever receiving requests for more formats, and this is definitely something we are looking into. Translations to other languages would be another great step.<br /><br />
  
 
We shall see…
 
We shall see…
 
</blockquote>
 
</blockquote>
== Services Used by the MagPi Team ==
 
  
=== DropBox ===
+
== Services used by the MagPi Team ==
  
A shared dropbox folder is used to share new articles or ideas.  Issues 1-9 are archived in a DropBox folder, but have since been updated in the github version.  If they do not have one, new volunteers will need to [http://dropbox.com create a DropBox account.]
+
=== Google Groups ===
  
When you start work on the magazine you will be added to the shared DropBox folder.
+
Members coordinate their efforts through the [https://groups.google.com/forum/?fromgroups#!forum/themagpi MagPi Google Group], which you will need to join when you become a volunteer.  
  
You may want to download a DropBox client for your OS.
+
You can subscribe via email or use the web interface.
  
'''Note: The main files for the MagPi Issues 1~9 are stored in the MagPi DropBox. By default, DropBox ''moves'' rather than ''copies'' files when you have a desktop client. Make sure that you only overwrite/move files when you are intending to!'''
+
=== DropBox ===
  
=== Google Groups ===
+
A shared dropbox folder is used to share new articles or ideas.  New volunteers will need to [http://dropbox.com create a DropBox account] and then request access to the DropBox via the email group.
  
Members coordinate their efforts through the MagPi Google Group, which you will need to join when you become a volunteer. You can subscribe via email or use the web interface.
+
You may want to download a DropBox client for your OS.
 +
 
 +
'''Note: The main files for the MagPi Issues 1~9 are archived in the MagPi DropBox. By default, DropBox ''moves'' rather than ''copies'' files when you have a desktop client. Make sure that you only overwrite/move files when you are intending to!'''
  
 
=== GitHub ===
 
=== GitHub ===
  
Articles for each of the issues and some articles in development are stored in GitHub.  For more information see [[http://elinux.org/TheMagPiGit | The MagPi Git]].
+
Articles for each of the issues and some articles in development are stored in GitHub, this is the main repository tool for volunteers working on layouts and graphics.   
  
=== Magazine Management System ===
+
For more information see [[http://elinux.org/TheMagPiGit | The MagPi Git]].
  
NOTE: THIS SECTION IS UNDER CONSTRUCTION. IT MAY HAVE OMISSIONS AND/OR INACCURACIES.
+
=== MMS (Magazine Management System) ===
  
MagPi team member Nick has built a Magazine Management System for the MagPi. It is used to organize who's working on what, merge .pdfs, assign tasks, and keep track what still needs to be done. It can be found at http://themagpi.com/mms. You will be added to the system as necessary.
+
MagPi team member Nick has built a [[TheMagPiMms|Magazine Management system]] for the MagPi where each magazine issue is outlined page by page. It is used to organize who's working on what, merge pdfs, assign tasks, and keep track what still needs to be done. It can be found at http://themagpi.com/mms. You will be added to the system as necessary.
  
== Software Used by the MagPi Team ==
+
== Software used by the MagPi Team ==
  
 
=== Scribus ===
 
=== Scribus ===
Line 94: Line 91:
  
  
== Joining the Team ==
+
== Fonts used by the MagPi Team ==
  
When you have decided you wish to join the MagPi team as a volunteer, send an email to '''editor@themagpi.com''' with the request and a short summary of your knowledge of the tools the team uses and/or some background about which areas you are interested or knowledgeable in.
 
  
== Configuring Scribus ==
+
The usage of specific fonts articles is detailed on the page:[[TheMagPiLayout|Layout &amp; fonts]]. Below is a listing of fonts that you will need to have installed on your computer for performing layout work:
  
If you are laying out a main article, make sure to read the [[TheMagPiLayout | MagPi Layout Guide]]. This will provide you with information regarding what fonts and font sizes to use, as well the download link for the generic MagPi article template.
 
  
== Resources for new Scribus users ==
+
* FreeSans Family - should be installed by default on Raspbian / with Scribus
 +
* Courier - should be installed by default on Raspbian / with Scribus
 +
* Monaco - manual installation see below.
 +
* BitStream - may need manual installation depending on what else you have installed, see below.
  
Scribus is a relatively complex program, so make sure to take some time to familiarize yourself with it before diving in to far.
 
  
Here are some useful tutorials and other resources about Scribus:
+
A list of fonts which are often missing from a non-Debian LINUX installation can be found at [http://www.themagpi.com/resources/fonts/ http://www.themagpi.com/resources/fonts/]
  
[http://wiki.scribus.net/canvas/Scribus The Scribus Wiki]<br />
+
 
[http://wiki.scribus.net/canvas/Category:HOWTO Scribus Wiki HowTo]<br />
+
===Monaco===
[http://www.scribd.com/doc/8745015/Scribus-Tutorial A Scribus Tutorial on Scribd]<br />
+
 
[http://wiki.scribus.net/canvas/Get_Started_with_Scribus Getting Started With Scribus]<br />
+
 
[http://wiki.scribus.net/canvas/Scribus_Video_Tutorials A list of Scribus Video Tutorials]
+
The Monaco font is freely available, but is not installed on Raspbian by default. To install the font, type the following in Terminal:
 +
 
 +
 
 +
<pre>
 +
cd ~
 +
wget http://www.themagpi.com/resources/fonts/Monaco/Monaco_Linux.ttf
 +
sudo mkdir -p /usr/share/fonts/truetype/custom
 +
sudo mv Monaco_Linux.ttf /usr/share/fonts/truetype/custom
 +
sudo fc-cache -f -v
 +
</pre>
 +
 
 +
===BitStream===
 +
 
 +
 
 +
Some new setups are missing the BitStream font, this can be installed by typing:
 +
 
 +
 
 +
<pre>
 +
sudo apt-get install xfonts-scalable
 +
</pre>
 +
 
 +
== Joining the Team ==
 +
 
 +
When you have decided you wish to join the MagPi team as a volunteer, send an email to '''editor@themagpi.com''' with the request and a short summary of your knowledge of the tools the team uses and/or some background about which areas you are interested or knowledgeable in.
  
 
== Starting Work ==
 
== Starting Work ==
  
 
After you have installed and familiarized yourself with the tools used, and joined the team, you can get started working on the magazine. One of the long time MagPi team members will assign an article, layout or correction via the Google Group, and you will be granted access to the DropBox and GitHub repository as needed.
 
After you have installed and familiarized yourself with the tools used, and joined the team, you can get started working on the magazine. One of the long time MagPi team members will assign an article, layout or correction via the Google Group, and you will be granted access to the DropBox and GitHub repository as needed.

Latest revision as of 08:16, 10 April 2013

TheMagPi.png

Main Readers Authors Volunteers Sponsors Advertising Translations


  • Quick start guide - A quick start guide to help new volunteers get the information they need.
  • Information for volunteers - A guide to help volunteers familiarize themselves with the team’s workflow / tools.
  • Information for authors - the process of submitting an article.
  • MagPi MMS - how to use the MagPi MMS.
  • MagPi GIT - how to use the MagPi GIT scripts.
  • Layout & fonts - description of the standard layout and associated fonts.
  • PDF creation - instructions for the generation of PDF for electronic and paper publication.


Introduction

It can be confusing when you first join the MagPi team. To ease the question load on the main organizers, here is a guide to help new volunteers familiarize themselves with the team’s workflow.

A Quick Overview of the MagPi Project

From the MagPi website:

What we make

We produce a magazine with the intent to help and offer advice to users of the Raspberry Pi. This started out as a simple idea on the well known forums, with a few of us getting together and deciding on a loose outline of what we wanted to achieve.

Over time many have joined and left the team, each bringing their own contribution and ideas to the final piece.

If you had asked us six months ago whether we thought the magazine would be half a year down the line, we would not have been sure. We are now able to offer printed copies, competitions, our own branded Raspberry Pi case, and stable mirrors on a website not entirely made in flash.

Where does the money go?

We all started out as volunteers - we are certainly not in this for the money. However, there are certain administrative costs that go toward producing a reliable magazine, and printing magazines is certainly not free. We get a small amount of money from every copy sold - and this goes towards funding the entire production team. We also hope to be able to offer more competitions, and better product testing.

You can help

Any donation is very gratefully received. However, you don’t have to put money into this to help us along - time is also one of our limiting factors. If you think you can be of any use in the general production, drop us an email.

The future

We had no idea how successful the magazine would be. Give us another six months, and there should be some real progress made. We are forever receiving requests for more formats, and this is definitely something we are looking into. Translations to other languages would be another great step.

We shall see…

Services used by the MagPi Team

Google Groups

Members coordinate their efforts through the MagPi Google Group, which you will need to join when you become a volunteer.

You can subscribe via email or use the web interface.

DropBox

A shared dropbox folder is used to share new articles or ideas. New volunteers will need to create a DropBox account and then request access to the DropBox via the email group.

You may want to download a DropBox client for your OS.

Note: The main files for the MagPi Issues 1~9 are archived in the MagPi DropBox. By default, DropBox moves rather than copies files when you have a desktop client. Make sure that you only overwrite/move files when you are intending to!

GitHub

Articles for each of the issues and some articles in development are stored in GitHub, this is the main repository tool for volunteers working on layouts and graphics.

For more information see [| The MagPi Git].

MMS (Magazine Management System)

MagPi team member Nick has built a Magazine Management system for the MagPi where each magazine issue is outlined page by page. It is used to organize who's working on what, merge pdfs, assign tasks, and keep track what still needs to be done. It can be found at http://themagpi.com/mms. You will be added to the system as necessary.

Software used by the MagPi Team

Scribus

Scribus is the Free and Open Source desktop publishing program used for the layout of the MagPi.

It is important that you use the same version of Scribus (1.4.1.svn) as the rest of the team.

At this point, the MagPi is created with Raspberry Pis, Debian Wheezy Virtual Machines, and sometimes other Linux distros running Scribus 1.4.1.svn. The team uses Raspberry Pi’s and Linux for compatibility, since many of the fonts installed on Mac OSX and Windows are proprietary.

Installing Scribus on Raspbian / Debian Wheezy VM

To install Scribus on a Raspberry Pi running the Raspbian distribution or a Debian Wheezy VM, enter into Terminal:

sudo apt-get install scribus


Installing Scribus on Ubuntu

As of 14/2/2013, the version of Scribus that is in the Ubuntu Software Centre is the correct version. In the USC it will read as Scribus 1.4.0, but once it is installed the title-bar will read Scribus 1.4.1.svn, which is the version used by the rest of the MagPi team.

GIMP

GIMP is the Free and Open Source desktop graphics editor used in the production of the MagPi.


Installing GIMP on Raspian

To install GIMP on a Raspberry Pi running the Raspbian distribution, enter into Terminal:

sudo apt-get install gimp


Fonts used by the MagPi Team

The usage of specific fonts articles is detailed on the page:Layout & fonts. Below is a listing of fonts that you will need to have installed on your computer for performing layout work:


  • FreeSans Family - should be installed by default on Raspbian / with Scribus
  • Courier - should be installed by default on Raspbian / with Scribus
  • Monaco - manual installation see below.
  • BitStream - may need manual installation depending on what else you have installed, see below.


A list of fonts which are often missing from a non-Debian LINUX installation can be found at http://www.themagpi.com/resources/fonts/


Monaco

The Monaco font is freely available, but is not installed on Raspbian by default. To install the font, type the following in Terminal:


cd ~
wget http://www.themagpi.com/resources/fonts/Monaco/Monaco_Linux.ttf
sudo mkdir -p /usr/share/fonts/truetype/custom 
sudo mv Monaco_Linux.ttf /usr/share/fonts/truetype/custom 
sudo fc-cache -f -v

BitStream

Some new setups are missing the BitStream font, this can be installed by typing:


sudo apt-get install xfonts-scalable

Joining the Team

When you have decided you wish to join the MagPi team as a volunteer, send an email to editor@themagpi.com with the request and a short summary of your knowledge of the tools the team uses and/or some background about which areas you are interested or knowledgeable in.

Starting Work

After you have installed and familiarized yourself with the tools used, and joined the team, you can get started working on the magazine. One of the long time MagPi team members will assign an article, layout or correction via the Google Group, and you will be granted access to the DropBox and GitHub repository as needed.