Contents
Your Articles
Library Articles
Library Publications
Library Editing
This section is aimed at members who are part of the library editor group. This information is public to enable all users to understand the full process.
Library Administration
This section is aimed at members who are part of the library administrator group. This information is public to enable all users to understand the full process.
Publication Administration
This section is aimed at members who are an administrator for one or more publications.
Your Articles
Create an Article [ top ]
Links are provided to the
create article page from both the main
library page and
Your Articles page.
This page provides you with the form for creating your article.
- Category: A selection menu listing all available categories. Select a category for your article to be grouped in. Note that subcategories are indented under their parent category. This field is required.
- Title: Enter a title for the articleThis field is required.
- Summary: The summary is a short paragraph giving an overview of the article. This is provided for users to read to decide whether they wish to read the full article. Some users use their introductory paragraph as the summary, if you do this, still include the paragraph in the main body of the article - as some users may not read the summary. This field is required.
- Body: This is the main content of the article. BBCode is enabled. This field is required.
- Project: This field will only show if you are a member of one or more projects. If you are submitting the article as part of your work for a project, you should select that project here. This will associate the article to that project. This field is optional.
When you have filled in all the required fields, you can preview, save or submit your article. The preview feature allows you to see how your article will look when submitted - this includes rendering of the BBCode. If you wish to continue work on the article at a later date, choose the 'Save as Draft' option. If you are finished with your article, click 'submit'. Note you will be unable to edit your article once it has been submitted.
Edit a Draft article [ top ]
Any article saved as a draft can be later previewed, edited, saved, and submitted.
You can view a list of your saved drafts in
Your Articles.
Clicking on the article's title will allow you to view it.
From here, you will have an edit option at the top of the page, this will take you to a page that works the same as that for originally creating the article.
You can still preview, save and submit the article.
Saving any changes will overwrite the previous saved draft.
Note: In some cases you may find your draft appears to have no category associated with it.
This means that the category is no longer available in the system and a new category must be chosen before you can save or submit the article.
View submitted articles [ top ]
You can view any article you have submitted by following the link provided in
HeadQuarters to 'Your Articles'. Here you will find all draft articles, and any articles you have submitted that are pending review or are live on the site. If an article has been deleted, you will be unable to view it.
Library Articles
View all articles in a category [ top ]
Simply navigate to the main library index page and click on the category you wish to view. This will take you to a page listing all articles within the category.
View all articles related to a project [ top ]
Go to the project page. If the project has any articles related to it, there will be an 'Articles Produced:' list item with a number. This number links to the page displaying the project's articles.
Alternatively, go to /projects/PROJECT/articles replacing PROJECT with the group name associated with the project.
View all articles by a user [ top ]
The easiest way is to find an article by the user and on the article page click on the user's nickname.
Alternatively, go to /library/author?name=NICKNAME where NICKNAME is replaced by whom you are searching for.
Change article sort order [ top ]
On any page listing articles, you can change the order they are sorted in by clicking on one of the arrows beside a column header. This will sort the articles by that column either ascending or descending.
Library Publications
What are Publications? [ top ]
Publications house grouped releases of articles. A release is called an 'Edition'. Articles within an edition may also be viewable in the usual library categories. However, there are also articles that are unique to one or more editions and cannot be viewed elsewhere. Usually a publication is managed by a brigade or project within CA to cover a topic (e.g. CyberArmy news and activities, privacy). An individual edition may have a more specific theme which articles within it will follow (e.g. CyberArmy brigade(s), identity theft).
Library Editing
Additional priviledges for library editors [ top ]
Library editors can:
- Edit Articles
- Change the status of an article (e.g. make it 'live', deleted, marked for publications only)
Edit an Article [ top ]
Navigate to the relevant article. At the top of the article, click the 'edit article' link. Here you can edit the category, title, summary and body of the article. Make the necessary changes and then click 'Preview' to check the article, or 'Save Updates' to update the article.
Changing the Status of an Article [ top ]
Navigate to the relevant article. At the top of the article, click the 'change status' link. Here you can select the status you wish the article to have and click 'Update'.
Library Administration
Additional priviledges for library administrators [ top ]
Library administrators have all priviledges of a library editor, publication administrator and can also:
- Create Categories
- Edit Categories (rename, change description)
- Delete Categories
- Create new publications
- Edit Publications (rename, change description, change administrator list)
Creating a new category [ top ]
From the main library page, there should be an admin link. Here you will find a form for creating new categories. Enter a suitable name, and description. The name should be short but self explanatory where possible. The description is shown on the category view page, and allows for further explanation of the topic. The 'parent category' should be set to
root to create a top-level category. To create a subcategory, simply choose the relevant parent category in this selection menu.
When ready, click 'create'. A message should indicate whether or not the category was successfully created.
Editing an existing category [ top ]
From the main library page, there should be an admin link. On this page use the 'Edit Category' section to select the category you want and click '>'. You will now be presented with a form where you can alter the title and description.
When ready, click 'update'. A message should indicate whether or not the category was successfully edited.
Deleting a category [ top ]
From the main library page, there should be an admin link. On this page use the 'Delete Category' section to select the category you want and click '>'. A message should indicate whether or not the category was successfully deleted. Note that only categories with no articles and no subcategories are available for deletion.
Creating a new publication [ top ]
From the main library page, there should be a 'publication center' link. This takes you to a page with a simple form at the top for publication creation. This works the same as that for creating articles (except there is no parent category/publication).
When ready, click 'create'. A message should indicate whether or not the publication was successfully created.
Editing an existing publication [ top ]
From the main library page, there should be a 'publication center' link. Below the create and delete forms, the existing publications are listed. Each publication has an 'edit' button beside it which will take you to the editing page.
Here, you can edit all aspects of the publication, its title, description and administration list. You can also create, edit, and delete editions for this publication - see the specific sections in this guide for further details on those.
If you wish to edit the title/desc/admin for the project, simply update the details in the form and then hit 'Update'. The publication will immediately be updated to reflect your changes.
Changing an article's associated project [ top ]
Navigate to the relevant article. At the top of the article, click the 'edit article' link. Along with the normal fields that an editor can update on an article, library admins can also change the associated project. Simply select the project from the drop down menu (this field is at the bottom of the form), or select '[choose one]' if the article should not be associated with a project. Then click 'Save Updates'.
Library Publication Administration
These activities require a user to be a library administrator, or have administration access to the publication being edited.
Creating a new publication [ top ]
This requires library administrator access.
From the main library page, there should be a 'publication center' link. This takes you to a page with a simple form at the top for publication creation. This works the same as that for creating articles (except there is no parent category/publication).
When ready, click 'create'. A message should indicate whether or not the publication was successfully created.
Editing an existing publication [ top ]
From the main library page, there should be a '
publication center' link. Below the create and delete forms, the existing publications are listed. Each publication has an 'edit' button beside it which will take you to the editing page.
Here, you can edit all aspects of the publication, its title, description and administration list. You can also create, edit, and delete editions for this publication - see the specific sections in this guide for further details on those.
If you wish to edit the title/desc/admin for the project, simply update the details in the form and then hit 'Update'. The publication will immediately be updated to reflect your changes.
Creating a new edition [ top ]
An edition can be created from the publication edit page. To access this page:
- From the main library page, click the 'publication center' link.
- Below the create and delete forms, the existing publications are listed. Click the 'edit' button beside the relevant publication.
On this page there is a 'Create Edition' form. Fill in the relevant title and description for the edition. When ready click 'Create'. The edition will immediately be created and shall be listed on this page near the bottom.
You can then edit your edition by clicking the 'edit' button beside the edition, or add articles to it by browsing through articles and using the available form at the top of the article view page. See the relevant sections in this guide for more specific instructions.
Editing an existing edition [ top ]
An edition can be edited from the edition edit page. To access this page:
- From the main library page, click the 'publication center' link.
- Below the create and delete forms, the existing publications are listed along with their editions. Click the 'edit' button beside the relevant edition.
- Alternatively, this page can be accessed via a direct link available at the top of the edition view page.
Here, you can edit all aspects of the edition, its status, title and description. You can also view the list of articles added to the edition, along with their weighting, as well as removing them from the edition.
If you wish to change the status of the edition, this can be done via the top section on this page. Simply select the status you wish the edition to have and click submit. The following explain the available status settings:
- Not Published: The edition is only available to those with admin access to the library or the publication that this edition belongs to. This is the default status when an edition is newly created, and should be used while the edition is being 'populated' by articles, and is not yet ready for public viewing.
- Published: The edition is viewable to all. This should be used once the edition has had all necessary articles added to it.
- Deleted: This should be used when an edition should no longer be added to or made publically viewable. It does not delete the edition from the system.
If you wish to edit the title and/or desc for the edition, simply update the details in the form and then hit 'Update'. The edition will immediately be updated to reflect your changes.
To remove articles from an edition, simply click the 'remove' button beside the relevant article in the bottom section of this page. Remember that to add articles to an edition, it is done from the article itself (this simplifies the process in comparison to having a giant list of articles for adding to an edition, or entering an article id!).
Adding articles to editions [ top ]
To add an article to an edition, you need to navigate to the article you wish to add. When viewing the relevant article, you should see a form near the top left hand side that allows you to select the edition you wish to add it to. Simply select the edition, choose a 'weighting' (or leave it at the default) and click '>'. The weighting is used to change the ordering of articles in an edition, they are ordered with the highest weighting being displayed at the top.
If you do not see this form, or the edition you wish to add it to is not listed, it may be due to one of the following:
- You do not have administration access to the relevant publication (and you are not a library administrator).
- The article has already been added to that edition.
- The edition does not exist!
Removing articles from an edition [ top ]
Articles can be removed from an edition via the edition edit page. To access this page:
- From the main library page, click the 'publication center' link.
- Below the create and delete forms, the existing publications are listed along with their editions. Click the 'edit' button beside the relevant edition.
- Alternatively, this page can be accessed via a direct link available at the top of the edition view page.
You can view the list of articles added to the edition, along with their weighting near the bottom of this page. Beside each article is a 'remove' link, simply click this and the article will immediately be removed from the edition.