Documentation: Tagged news and events, country pages
As you can see on the UK page, it is possible to display news or events that have a special tag, e.g. a country code. This helps setting up pages easily with specific news items or events. The list of people displayed on this same page has also been automated, so it makes it easy to implement your own country page.
A tag key should be in lowercase and not contain any spaces, colons, and slashes. So for instance, the key for the tag “very important subject” should be
The content of the tag should be translated and human readable, because it will be shown on certain pages. For instance, if you tag a page about the Windows Tax.
<tag key="windows-tax">Windows Tax</tag>
Tag pages, news and events
For most pages (when your file has the xhtml), the tags must be added within <html> </html> usually at the end.
A list of tags currently in use can be found here. We also have a list of all tagged pages, events and news. Please check these pages first to avoid making duplicated tags, use existing tags if possible to keep things consistent.
- For certain news item the tags must be within <news> </news> if your file has the xml extension:
<news> [...] <tags> <tag key="front-page"/> <tag key="swpat">Software Patents</tag> <tag key="novell">Novell</tag> </tags> </news>
- For events, within <event> </event>:
<event> [...] <tags> <tag key="front-page"/> <tag key="it">Italy</tag> </tags> </event>
Please note that only events and news items being tagged as front-page will appear on the front page of fsfe.org!
Tag keys should all be written in English; there is no need for translation since they do not appear online, but are used internally for filtering news items or events.
Tagging author, date and download files
In order to give proper credits to the authors of articles you can add tags like these:
<author> <name>John Doe</name> <link>http://johndoe.me</link> <avatar>http://johndoe.me/me.png</avatar> </author> <!-- For FSFE team members, you can take the information directly from /about/people/people.en.xml, for instance: --> <author id="gerloff" /> <date> <revision content="2010-03-24" /> <original content="2009-11-27" /> </date> <!-- Feel free to add more than one revision tag if see fit --> <download type="pdf" content="/link/to/download-file.pdf" />
Bear in mind that these tags should be included like any other tags, that means they should be at the end, before </html>