Browse Source

more explanation on new tags

svn path=/trunk/; revision=29544
pull/8/head
hugo 8 years ago
parent
commit
bc6c159d14
  1. 33
      contribute/web/tagging.en.xhtml

33
contribute/web/tagging.en.xhtml

@ -19,55 +19,40 @@
so it makes it easy to implement your own country page.
</p>
<p>
<!--p>
<img src="/graphics/icons/warning.png" />
The first system we have used, an attribute consisting of
comma-separated values, was not very adapted to the way we generate
dynamic information.
Therefore, we have opted for the hereunder defined system, a more
xml-style one.
</p>
</p-->
<h2>Basic instructions</h2>
<p>
A tag should be in <a href="https://en.wikipedia.org/wiki/CamelCase">CamelCase</a> except for special tags like <code>front-page</code>, <code>newsletter</code>. So for instance, the tag “very important subject” should be <code>VeryImportantSubject</code>.
A tag should contain a <code>content</code> attribute except for special tags. This attribute 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:
A tag should contain a <code>content</code> attribute except for special tags. <bold>This attribute should be translated and human readable</bold>, because it will be shown on certain pages. For instance, if you tag a page about the Windows Tax and about a ruling:
</p>
<pre class="file">
&lt;tag content="Windows Tax"&gt;WindowsTax&lt;/tag&gt;
&lt;tag content="Ruling"&gt;Ruling&lt;/tag&gt;
</pre>
<h2>Tagged news and events</h2>
<p>In order to retrieve news items or events with a given tag, these
have of course to be tagged accordingly. To do that, add as many
<var>&lt;tag content=""&gt;...&lt;/tag&gt;</var> as necessary in the tags section.</p>
<h2>Tag pages, news and events</h2>
<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>
<p>
A list of tags currently in use can be found <a href="/tags/tags.html">here</a>.
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.
</p>
<ul>
<li>For news items and newsletters, within &lt;html&gt; &lt;/html&gt; if your file has the <var>xhtml</var> extension:</li>
</ul>
<pre class="file">
&lt;html&gt;
[...]
&lt;tags&gt;
&lt;tag&gt;front-page&lt;/tag&gt;
&lt;tag content="Software Patents"&gt;Swpats&lt;/tag&gt;
&lt;tag content="Novell"&gt;Novell&lt;/tag&gt;
&lt;/tags&gt;
&lt;/html&gt;
</pre>
<ul>
<li>And, within &lt;news&gt; &lt;/news&gt; if your file has the <var>xml</var> extension:</li>
<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>
</ul>
<pre class="file">

Loading…
Cancel
Save