Source files of fsfe.org, pdfreaders.org, freeyourandroid.org, ilovefs.org, drm.info, and test.fsfe.org. Contribute: https://fsfe.org/contribute/web/ https://fsfe.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

139 lines
4.5 KiB

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <html>
  3. <version>1</version>
  4. <head>
  5. <title>Documentation - Tagged news and events, country pages</title>
  6. </head>
  7. <body class="article" microformats="h-entry">
  8. <p id="category"><a href="/contribute/web/">Webmastering</a></p>
  9. <h1 class="p-name">Documentation: Tagged news and events, country pages</h1>
  10. <div class="e-content">
  11. <p id="introduction" class="p-summary">
  12. As you can see on <a href="/uk/uk.html">the UK page</a>,
  13. it is possible to display news or events that have a special tag,
  14. e.g. a country code.
  15. This helps setting up pages easily with specific news items or events.
  16. The list of people displayed on this same page has also been automated,
  17. so it makes it easy to implement your own country page.
  18. </p>
  19. <h2>Basic instructions</h2>
  20. <p>
  21. 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 <code>very-important-subject</code>.
  22. 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.
  23. </p>
  24. <pre class="file">
  25. &lt;tag key="windows-tax"&gt;Windows Tax&lt;/tag&gt;
  26. </pre>
  27. <h2>Tag pages, news and events</h2>
  28. <p>For most pages (when your file has the <var>xhtml</var>), the tags must be added within &lt;html&gt; &lt;/html&gt; usually at the end.</p>
  29. <p>
  30. A list of tags currently in use can be found <a href="/tags/tags.html">here</a>.
  31. We also have a list of <a href="/tags/tagged.html">all tagged pages, events and news</a>. <strong>Please check these pages first</strong> to avoid making duplicated tags, use existing tags if possible to keep things consistent.
  32. </p>
  33. <ul>
  34. <li>For certain news item the tags must be within &lt;news&gt; &lt;/news&gt; if your file has the <var>xml</var> extension:</li>
  35. </ul>
  36. <pre class="file">
  37. &lt;news&gt;
  38. [...]
  39. &lt;tags&gt;
  40. &lt;tag key="front-page"/&gt;
  41. &lt;tag key="swpat"&gt;Software Patents&lt;/tag&gt;
  42. &lt;tag key="novell"&gt;Novell&lt;/tag&gt;
  43. &lt;/tags&gt;
  44. &lt;/news&gt;
  45. </pre>
  46. <ul>
  47. <li>For events, within &lt;event&gt; &lt;/event&gt;:</li>
  48. </ul>
  49. <pre class="file">
  50. &lt;event&gt;
  51. [...]
  52. &lt;tags&gt;
  53. &lt;tag key="front-page"/&gt;
  54. &lt;tag key="it"&gt;Italy&lt;/tag&gt;
  55. &lt;/tags&gt;
  56. &lt;/event&gt;
  57. </pre>
  58. <p>Please note that only events and news items being tagged as <var>front-page</var>
  59. will appear on the front page of fsfe.org!</p>
  60. <p>
  61. Tag keys should all be written in English; there is no need for translation
  62. since they do not appear online, but are used internally for
  63. filtering news items or events.
  64. </p>
  65. <h3>Tagging author, date and download files</h3>
  66. <p>
  67. In order to give proper credits to the authors of articles you can add
  68. tags like these:
  69. </p>
  70. <pre class="file">
  71. &#60;author&#62;
  72. &#60;name&#62;John Doe&#60;/name&#62;
  73. &#60;link&#62;http://johndoe.me&#60;/link&#62;
  74. &#60;avatar&#62;http://johndoe.me/me.png&#60;/avatar&#62;
  75. &#60;/author&#62;
  76. &#60;!-- For FSFE team members, you can take the information directly
  77. from /about/people/people.en.xml, for instance: --&#62;
  78. &#60;author id="gerloff" /&#62;
  79. &#60;date&#62;
  80. &#60;revision content="2010-03-24" /&#62;
  81. &#60;original content="2009-11-27" /&#62;
  82. &#60;/date&#62;
  83. &#60;!-- Feel free to add more than one revision tag if see fit --&#62;
  84. &#60;download type="pdf" content="/link/to/download-file.pdf" /&#62;
  85. </pre>
  86. <p>
  87. Bear in mind that these tags should be included like any other tags, that means they should be at the end, before &#60;/html&#62;
  88. </p>
  89. </div>
  90. <!--/e-content-->
  91. </body>
  92. <sidebar promo="about-fsfe">
  93. <div id="related-content">
  94. <h3>Other howtos:</h3>
  95. <ul>
  96. <li>
  97. <a href="/contribute/web/css.html">Edit the CSS with LESS</a>
  98. </li>
  99. <li>
  100. <a href="/contribute/template.html">A template article, to use the new webdesign</a>
  101. </li>
  102. </ul>
  103. </div>
  104. </sidebar>
  105. </html>
  106. <!--
  107. Local Variables: ***
  108. mode: xml ***
  109. End: ***
  110. -->