Difference between revisions of "Powerbase:Quick Guide to Getting Started"

From Powerbase
Jump to: navigation, search
(Referencing)
m (Quick Tips for Editing Powerbase: broken link fixed)
 
(31 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{SpinProfiles:Help}}
+
{{Powerbase:Help}}
==1. Register==
+
 
First you need to register as a User by emailing editor AT spinprofiles.org. Tell us a bit about who you are, what your background is, and what you want to write about. You don't need any special credentials but SpinProfiles editors need to establish that you are approaching the project in a spirit of goodwill. If SpinProfiles editors approve you as a User, you will be sent a username and password by email.
+
==Register==
 +
 
 +
First you need to register as a User by emailing melissa.jones AT powerbase.info. Tell us a bit about who you are, what your background is, and what you want to write about. You don't need any special credentials but Powerbase editors need to establish that you are approaching the project in a spirit of goodwill. If Powerbase editors approve you as a User, you will be sent a username and password by email.
 +
 
 +
 
 +
 
 +
==Write your article==
 +
 
 +
Write your article for Powerbase in Word or similar. Please ensure that your article meets our requirements for [[Powerbase:Libel|avoiding libel]] before submitting it to Powerbase.
 +
 
 +
 
 +
 
 +
==Reference your article properly==
 +
 
 +
 
 +
 
 +
While researching and writing your article, take care to reference it according to Powerbase style – see our [[A_Guide_to_Referencing|guide to referencing]]. You will need to code the references within your body text as laid out in the Guide.
 +
 
 +
 
 +
 
 +
If you code your references correctly, they will automatically number themselves in order and appear at the foot of the article.
 +
 
 +
 
 +
 
 +
To see an example of an article with references coded in the format agreed by Powerbase editors, go to
 +
 
 +
http://www.powerbase.info/index.php?title=Alliance_for_Abundant_Food_and_Energy&action=edit
 +
 
 +
 
 +
 
 +
Many of the older articles are not referenced in this way but editors are working to standardize references according to the new system.
 +
 
 +
 
 +
 
 +
==Submit your article==
 +
 
 +
Now put your article on the Powerbase site. You may find the best browser is Firefox as Safari sometimes times out.
  
==2. Write your article==
 
Write your article for SpinProfiles in Word or similar, taking care to write and reference it according to Spinprofiles’ referencing style as laid out at http://www.spinprofiles.org/index.php/SpinProfiles:A_Guide_to_Referencing
 
  
==3. Submit your article==
 
Now put your article on the Spinprofiles site. You may find the best browser is Firefox as Safari sometimes times out.
 
  
 
Go to
 
Go to
http://www.spinprofiles.org
+
 
 +
http://www.powerbase.info
 +
 
 
and log in using the user name and password that you have been sent via email.
 
and log in using the user name and password that you have been sent via email.
 +
 +
  
 
In the left hand side menu Navigation, click on Article Submission. Scroll down until you find the article submission box for the portal to which you want to contribute an article. Each portal has two boxes: Box 1 for a person and Box 2 for an organisation.  
 
In the left hand side menu Navigation, click on Article Submission. Scroll down until you find the article submission box for the portal to which you want to contribute an article. Each portal has two boxes: Box 1 for a person and Box 2 for an organisation.  
  
The list of portals is on the main page http://www.spinprofiles.org/index.php/Main_Page under the header "Spinprofiles portals". If your article doesn't fit into any of the portals, then you can use Box 1a (generic) or 1b (generic).
+
 
 +
 
 +
The list of portals is on the main page http://www.powerbase.info/index.php/Main_Page under the header "Powerbase portals". If your article doesn't fit into any of the portals, then you can use Box 1a (generic) or 1b (generic).
 +
 
 +
 
  
 
Type into either Box 1 (person) or Box 2 (organisation) the name of your target subject. Use a person's actual name rather than any grand title they may have, so: Jane Smith, not Baroness Smith of Biggsville. Do not use "The" unless the page title will not make sense without it. So you would put "Heritage Foundation", not "The Heritage Foundation", but you would put "The Times" as just "Times" would not make sense.
 
Type into either Box 1 (person) or Box 2 (organisation) the name of your target subject. Use a person's actual name rather than any grand title they may have, so: Jane Smith, not Baroness Smith of Biggsville. Do not use "The" unless the page title will not make sense without it. So you would put "Heritage Foundation", not "The Heritage Foundation", but you would put "The Times" as just "Times" would not make sense.
 +
 +
  
 
Click on Create Article. A page opens called “Editing [your target]”.
 
Click on Create Article. A page opens called “Editing [your target]”.
  
There is a series of headers already provided as a template but you don’t have to stick to these – they’re just suggestions. You can substitute your own headers within the header formatting codings: == for first level subheads and === for second level subheads.
 
  
Please keep the Notes/references header coding at the foot of the template as it is, as this is where your references will automatically go.
+
 
 +
A series of headers is already provided in the template but you don’t have to stick to these. You can substitute your own headers within the header formatting codings: == for first level subheads and === for second level subheads.
 +
 
 +
 
 +
 
 +
Please keep the Notes/references header coding at the foot of the template, as this is where your references will automatically go. This piece of coding looks like this:
 +
 
 +
:<nowiki>==Notes==</nowiki>
 +
 
 +
:<nowiki><references/></nowiki>
 +
 
 +
 
  
 
Copy and paste your article into the template, with each section under the appropriate header. Put nothing in the Notes/references section as these will appear automatically once you have formatted your references in the body text.
 
Copy and paste your article into the template, with each section under the appropriate header. Put nothing in the Notes/references section as these will appear automatically once you have formatted your references in the body text.
 +
 +
  
 
You can Save Article (click on button at bottom of page) at any point to save, and you might want to do this frequently in case your session times out and you lose data. Your article will appear as it will look to the reader. This is a good way of checking that you are coding things correctly as you go. Then return to the Edit page by clicking Edit at the top menu. Do some more on your article, then Save Page again.
 
You can Save Article (click on button at bottom of page) at any point to save, and you might want to do this frequently in case your session times out and you lose data. Your article will appear as it will look to the reader. This is a good way of checking that you are coding things correctly as you go. Then return to the Edit page by clicking Edit at the top menu. Do some more on your article, then Save Page again.
  
==Referencing==
+
==Quick Tips for Editing Powerbase==
  
Code the references within your body text.
+
See: [[Powerbase:Quick Guide to Editing (cheatsheet)]]
  
Please read the comprehensive guide to referencing SpinProfiles articles at [[A_Guide_to_Referencing]]
+
==Make sure your article has a category==
  
This includes notes on how to code your references so that they show up properly in the article, number themselves in order, and appear at the foot of the article.
 
  
To see an example of an article with references coded in the format agreed by Spinprofiles editors, go to
 
http://www.spinprofiles.org/index.php?title=Alliance_for_Abundant_Food_and_Energy&action=edit
 
  
Many of the older articles are not referenced in this way but editors are working to standardize references according to the new system.
+
Assigning your target person/organization to a category enables a person searching the Powerbase site by category to find your article.
  
===Categories===
 
  
Your article template has a Categories section. Assigning your target person/organization to a category enables a person searching the SpinProfiles site by category to come across your article.
 
  
 
If you are submitting your article through the Articles Submission system, a list of categories will be provided at the foot of the page. Delete those that don't apply and keep those that do.
 
If you are submitting your article through the Articles Submission system, a list of categories will be provided at the foot of the page. Delete those that don't apply and keep those that do.
  
If your new article has no categories provided already, or if you are updating an old page without categories, you will need to choose an appropriate category or categories. Go to the [http://www.spinprofiles.org/index.php?title=Special:Categories&limit=500 Categories page] of Spinprofiles. Choose as many categories as your person/organization fits into. Type each category into the Categories section of your article template or use the following format: <nowiki>[[Category:category name]]</nowiki>
 
  
For example, for a lobby group pushing GM crops and foods, you might want to assign them to the following categories: GM Lobby Groups and Biotechnology. You would code this as follows, taking care not to put spaces between the word "Category" and the category name, and enclosing the entire phrase in a pair of square brackets [[    ]]:
+
 
 +
If your new article has no categories provided already, or if you are updating an old page which does not have categories, you will need to add an appropriate category or categories. Go to the [http://www.powerbase.info/index.php?title=Special:Categories&limit=500 Categories page] of Powerbase. Choose as many categories as your person/organization fits into. Type each category into the Categories section of your article template or use the following format: <nowiki>[[Category:category name]]</nowiki>
 +
 
 +
 
 +
 
 +
For example, for a lobby group pushing GM crops and foods in developing countries, you might want to assign them to the following categories:
 +
 
 +
 
 +
 
 +
:GM Lobby Groups  
 +
 
 +
 
 +
 
 +
and  
 +
 
 +
 
 +
 
 +
:Third World Lobbyists (GM).  
 +
 
 +
 
 +
 
 +
You would code this as follows, taking care not to put spaces between the word "Category" and the category name, and enclosing the entire phrase in a pair of square brackets [[    ]]:
 +
 
 +
 
 +
 
 
<nowiki>[[Category:GM Lobby Groups]]</nowiki>
 
<nowiki>[[Category:GM Lobby Groups]]</nowiki>
  
<nowiki>[[Category:Biotechnology]]</nowiki>
 
  
===Coding names of people and organizations===
 
  
The first time you mention a person or organisation in your article (other than the one your article is about), put their name in double square brackets [[    ]]. For subsequent mentions, don't put them in square brackets – as if we put in too many of these we risk making the page look messy.  
+
<nowiki>[[Category:Third World Lobbyists (GM)]]</nowiki>
 +
 
 +
 
 +
 
 +
==Make links out of the names of people and organizations==
 +
 
 +
 
 +
 
 +
The first time you mention a person or organisation in your article (other than the one your article is about), put their name in double square brackets [[    ]]. This will create a link to the page on that person or organisation, if such a page exists, enabling the reader to click on the name and be taken to the relevant page. For subsequent mentions, don't bother, as if there are too many links, we risk making the page look messy.  
 +
 
 +
 
  
 
What you put in:
 
What you put in:
 +
 +
  
 
<nowiki>In June 2008, [[Monsanto]]’s chief technology officer [[Rob Fraley]] said ….</nowiki>
 
<nowiki>In June 2008, [[Monsanto]]’s chief technology officer [[Rob Fraley]] said ….</nowiki>
 +
 +
  
 
What you see:
 
What you see:
 +
 +
  
 
In June 2008, [[Monsanto]]’s chief technology officer [[Rob Fraley]] said ….
 
In June 2008, [[Monsanto]]’s chief technology officer [[Rob Fraley]] said ….
  
This will enable the reader to click on the name and be taken to any page that exists on that person or org. Don’t worry if there is no page yet: in that case, the name will appear in a different colour automatically to alert the reader to that fact.
 
  
===Saving page===
 
  
When you’ve done your article in the Edit page, click on Save Page.
+
Don’t worry if no page yet exists on that person or organisation: in that case, the name will appear in red automatically to alert the reader to that fact.
 +
 
 +
 
 +
 
 +
==Save your page==
 +
 
 +
 
 +
 
 +
Every time you make substantial changes your article in Edit mode, click on Save Page. Do this often to avoid losing data.
 +
 
 +
 
  
 
That’s it!
 
That’s it!
  
If you have any questions, email claire.robinson AT spinprofiles.org
 
  
[[Category:SpinProfiles Help]]
+
 
[[Category:SpinProfiles policy and guideline pages]]
+
==Other useful information==
 +
 
 +
 
 +
 
 +
Other Powerbase pages that you may find useful and that Powerbase editors may draw your attention to as needed are:
 +
 
 +
 
 +
 
 +
:[[Powerbase:Editorial_Policy|Editorial policy]] | [[Powerbase:A_Guide_to_Sourcing|Guide to sourcing]] | [[Powerbase:A_Guide_to_Tone|Guide to tone]] | [[Powerbase:Copyrights|Copyrights]] | [[Powerbase:How_to_Start_a_Page|How to start a page]] | [[Powerbase:How_to_Structure_an_Article|How to structure an article]] | [[Powerbase:Etiquette|Etiquette]] | [[Powerbase:Image_Use_Policy_and_Guidelines|Uploading images]].
 +
 
 +
 
 +
 
 +
If you have any questions, email melissa.jones AT powerbase.info
 +
 
 +
 
 +
 
 +
[[Category:Powerbase Help]]

Latest revision as of 12:23, 9 January 2012

Help Guide

How do I do that?

Getting in touch

Information and resources for contributors

Register

First you need to register as a User by emailing melissa.jones AT powerbase.info. Tell us a bit about who you are, what your background is, and what you want to write about. You don't need any special credentials but Powerbase editors need to establish that you are approaching the project in a spirit of goodwill. If Powerbase editors approve you as a User, you will be sent a username and password by email.


Write your article

Write your article for Powerbase in Word or similar. Please ensure that your article meets our requirements for avoiding libel before submitting it to Powerbase.


Reference your article properly

While researching and writing your article, take care to reference it according to Powerbase style – see our guide to referencing. You will need to code the references within your body text as laid out in the Guide.


If you code your references correctly, they will automatically number themselves in order and appear at the foot of the article.


To see an example of an article with references coded in the format agreed by Powerbase editors, go to

http://www.powerbase.info/index.php?title=Alliance_for_Abundant_Food_and_Energy&action=edit


Many of the older articles are not referenced in this way but editors are working to standardize references according to the new system.


Submit your article

Now put your article on the Powerbase site. You may find the best browser is Firefox as Safari sometimes times out.


Go to

http://www.powerbase.info

and log in using the user name and password that you have been sent via email.


In the left hand side menu Navigation, click on Article Submission. Scroll down until you find the article submission box for the portal to which you want to contribute an article. Each portal has two boxes: Box 1 for a person and Box 2 for an organisation.


The list of portals is on the main page http://www.powerbase.info/index.php/Main_Page under the header "Powerbase portals". If your article doesn't fit into any of the portals, then you can use Box 1a (generic) or 1b (generic).


Type into either Box 1 (person) or Box 2 (organisation) the name of your target subject. Use a person's actual name rather than any grand title they may have, so: Jane Smith, not Baroness Smith of Biggsville. Do not use "The" unless the page title will not make sense without it. So you would put "Heritage Foundation", not "The Heritage Foundation", but you would put "The Times" as just "Times" would not make sense.


Click on Create Article. A page opens called “Editing [your target]”.


A series of headers is already provided in the template but you don’t have to stick to these. You can substitute your own headers within the header formatting codings: == for first level subheads and === for second level subheads.


Please keep the Notes/references header coding at the foot of the template, as this is where your references will automatically go. This piece of coding looks like this:

==Notes==
<references/>


Copy and paste your article into the template, with each section under the appropriate header. Put nothing in the Notes/references section as these will appear automatically once you have formatted your references in the body text.


You can Save Article (click on button at bottom of page) at any point to save, and you might want to do this frequently in case your session times out and you lose data. Your article will appear as it will look to the reader. This is a good way of checking that you are coding things correctly as you go. Then return to the Edit page by clicking Edit at the top menu. Do some more on your article, then Save Page again.

Quick Tips for Editing Powerbase

See: Powerbase:Quick Guide to Editing (cheatsheet)

Make sure your article has a category

Assigning your target person/organization to a category enables a person searching the Powerbase site by category to find your article.


If you are submitting your article through the Articles Submission system, a list of categories will be provided at the foot of the page. Delete those that don't apply and keep those that do.


If your new article has no categories provided already, or if you are updating an old page which does not have categories, you will need to add an appropriate category or categories. Go to the Categories page of Powerbase. Choose as many categories as your person/organization fits into. Type each category into the Categories section of your article template or use the following format: [[Category:category name]]


For example, for a lobby group pushing GM crops and foods in developing countries, you might want to assign them to the following categories:


GM Lobby Groups


and


Third World Lobbyists (GM).


You would code this as follows, taking care not to put spaces between the word "Category" and the category name, and enclosing the entire phrase in a pair of square brackets [[ ]]:


[[Category:GM Lobby Groups]]


[[Category:Third World Lobbyists (GM)]]


Make links out of the names of people and organizations

The first time you mention a person or organisation in your article (other than the one your article is about), put their name in double square brackets [[ ]]. This will create a link to the page on that person or organisation, if such a page exists, enabling the reader to click on the name and be taken to the relevant page. For subsequent mentions, don't bother, as if there are too many links, we risk making the page look messy.


What you put in:


In June 2008, [[Monsanto]]’s chief technology officer [[Rob Fraley]] said ….


What you see:


In June 2008, Monsanto’s chief technology officer Rob Fraley said ….


Don’t worry if no page yet exists on that person or organisation: in that case, the name will appear in red automatically to alert the reader to that fact.


Save your page

Every time you make substantial changes your article in Edit mode, click on Save Page. Do this often to avoid losing data.


That’s it!


Other useful information

Other Powerbase pages that you may find useful and that Powerbase editors may draw your attention to as needed are:


Editorial policy | Guide to sourcing | Guide to tone | Copyrights | How to start a page | How to structure an article | Etiquette | Uploading images.


If you have any questions, email melissa.jones AT powerbase.info