This page will contain resources for production of Overload.

====== Adding an Overload Journal ======

The basic process for adding a new journal to the site is described here. Note that none of this will work if you are not logged in. And your username will need to have the correct permissions to administer the journal pages.

===== Overview =====

A 'journal' in the system is a category containing a collection of articles. Each journal is a new category. The categories are heirarchical, meaning that there is a 'Journal' category, which contains 'CVu' and 'Overload' sub cats. Each of these subcats contains a subcat for each journal (i.e. Overload 75, CVu 18.6 etc.).

A journal consists of a series of articles and (usually) a PDF of the journal. So each article needs to be entered as a new article and then assigned to the correct category. Articles are of publication type 'Journal' and the PDFs are of publication type 'PDF'.

===== The process =====

This is the process for a adding a new journal to the site (using Overload 99 for example):

  - Create a new category for the journal:
    * Admin -> Categories -> Add Category
    * Name = '99' (Just the number)
    * Description = 'Overload Journal #99 - Dec 2010'
    * In relation to = select 'Journals -- Overload -- 98' (the previous journal)
    * Position = 'Right before, in the same level'
    * Optional Image = 'overload.png'
    * Click 'Add'
  - Add the articles to the category (do this for each article).
    * Admin -> Articles -> Add Article
    * Select Publication Type 'Journal'
    * Title = the article title
    * Summary = a short summary of the article (One or two sentences is sufficient)
    * Body = the body of the article (see below for formatting issues).
    * Notes = whatever, not currently displayed.
    * Publication date = Journal articles are ordered by date (desc), so make the Editorial a **later** date than the other articles for it to appear at the top of the listing.
    * Status = Submitted means it doesn't show immediately, Approved means that it does. Can be changed later.
    * Categories (first) = select the appropriate journal category (Journals - Overload - 99 in this case)
    * Categories (second, third) = these are optional and can provide further routes to the article.
    * Keywords = set of keywords for the article (e.g. java, patterns etc.)
    * AuthorName = name of author
    * AuthorEmail = email of author
    * AuthorName2,Authoremail2 = again if there is a second author
    * Click 'Preview' to preview the article, 'Save and Edit' to save and continue or 'Add Article' to add it to the system.
    * Until(all articles entered) repeat;
  - Add the PDF to the category
    * Admin -> Articles -> Add Article
    * Select Publication Type 'PDF File'
    * Title = 'Overload 99 PDF'
    * File = use the File selector button to upload the PDF from your local system to server
    * Category = select the appropriate category (Journals - Overload - 99 in this case).
    * Click 'Add Article'

==== Text formatting ====

The 'Summary' and 'Body' fields **require** correct HTML formatting. Look at previous entries if you are not sure what is needed. When importing the articles from the old server, I basically stripped off the header section, the body and end body tags and left the formatting as it was. The old style sheets have been folded into the system stylesheet so the styles have not changed.

Typically the Summary field requires little more than enclosing the text in <p>...</p> tags. (And even that is not really necessary).

==== Images ====

How to add images...

===== Notes =====

  * I recommend having all the text set up in an editor on your desktop. If there is an error in the system, or if your session times out (easy when the phone rings) you will lose whatever is being entered. So set it up and cut and paste into the fields.