Creating content

Creating content for the site is quite easy. Once that the "Content Type" you want to add is selected, you'll be carried to a data-entry form, where you'll have to fill some fields. Some of the tasks to fulfill are common, and other are quite specific for every content type.

Just to explain some concepts on what really is "Creating content". What you're are creating is a node. And every node has a workflow. This didn't help much, but we are entering into it right now. The workflow is the different stages that a node can have. To set things more clear. When you create a node, the last part of the creating form is always the same:

If a node is submitted but not published, the node is not public, and the information shall be available only for the user that has created the node. This is useful when you haven't finished it or when you want somebody else to revise it before going public. What's more, all of the nodes created but not published are listed here.

Set clear that if a node is not published, it shall not be found and therefore listed by any of the tools in the site. Once the content has been published, it's available in the site for the different tools, as listings, filters, etc.

The other three options are easier, and with almost no use for us.

Adding Bibliographical references and footnotes to a Story

To add a Biblio reference, first thing you should check is that the referenced article is present in our database (Browse->Bibliographical references). If it is not, just create it.

There's a faster way to know if the article is listed in the database. When adding the Story, check the field "bibref" above the "Body" field.

In that field type part of the title for the searched reference:

Select the article to be referred. You'll see something like:

Now, the tricky part. In the Body field, write your article. To add the reference, click the upper-left "Fuente HTML" or "HTML Source" or whichever it is in the language you have the browser on. And everything becomes a litlle messy, as what you're looking into now is the real HTML code for what you're writing. Doing it for this article:

 

Don't panic (although this code can become really messy, the text can be easilly followed for a typical article) and look for the place where to add the reference. Once located, add <bib>2789</bib>, being "2789" the "nid" given in the bibref field for your article. It will look like 1

And that's it. Click on the upper-left "Fuente HTML" or "HTML Source"again and the tick is done. When you publish the article, an ordered sequence of references shall be created. One last thing, delete the content in the "bibref" field, if you do not want that messing in your article everywhere.

The best part is that references are integrated with footnotes. To add a footnote the process is the same, but instead of typing <bib>2789</bib>, type <fn>TEXT OF THE FOOTNOTE</fn>, and reference numbers shall be created and ordered. Doing it2

We're working on the messy part to make it more efficient, but that's how it has to be done by now.

 

  1. 1. Espadaler X .  2007.  The ants of El Hierro (Canary Islands). Memoirs of the American Entomological Institute. 80:113-127.
  2. 2. Easy,uh?

Submitting "Biblio"

Next thing you find is a dialog box asking for the type of biblio you want to add. There are four types available, and all of them are filled in almost the same way.

 

If "Journal Article" is selected, you'll enter the submitting form. Everything is quite straightforward, except the Authors field. The biblio content type comes with an integrated feature that selects the different formats of a name and changes them in the presentations and filtering options. For instance, if I enter "John Doe", "J. Doe" or "Doe, J.", the system will present them always as "Doe, J." and shall filter any biblio reference with any of the three names under "Doe, J.".

But to do this, we must tell the system when a name begins and finishes. This is done separating the different names by semicolons in a format like this:

X. Espadaler; Cagniant, H.; Barry Bolton

The system recognizes the different names between the semicolons and translates it to:

Espadaler, X.; Cagniant, H.; Bolton, B.

And lists the article under any of these three authors, no matter the name structure you gave them in the authors field.

The "Journal Title" tries to match your words to the existing journals already existing in the database. if you find one in the list shown below the field, just select it.

From "Pages" and below there are some fields that in most of ocassions shall not be filled, as they are "Journal Date", "ISSN Number" and "ISBN Number" and others. We'll just note here the two most important of them, as they are "URL" and "File attachments".

"URL" is the link to the location where the full article can be found. We've decided to link our database to the magnificent database of antbase. So please, if the reference you're entering is available there, just add here the link to the pdf.

If not, you can always add a pdf to the biblio, via the "File attachments" tool. Just browse it and upload it. Please: DO NOT UPLOAD ANY COPYRIGHTED MATERIAL unless you've the permit of editors and/or authors.

The rest of the options are common to all the content types and explained in other sections of this book.

Don't forget to Publish it before submitting.

 

Adding a link to a certain taxon

Let's suppose that I'm writing a story and I want a link to a certain species appear. Well, just type the plain name. If the species is listed in the system as valid, a link will be automatically created. If it is listed as a synonym, it will take you to the valid species summary page. For example:

Please, have into account that the system is quite clever, but some weird things can happen, as this:

  • Anergates barbarus

The system recognizes Anergates as valid, and will create a link to that genus, but will not be capable to tell you that such an species does not exist