summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'metadata/dtd/mirrors.dtd')
-rw-r--r--metadata/dtd/mirrors.dtd89
1 files changed, 89 insertions, 0 deletions
diff --git a/metadata/dtd/mirrors.dtd b/metadata/dtd/mirrors.dtd
new file mode 100644
index 000000000000..d855815851f4
--- /dev/null
+++ b/metadata/dtd/mirrors.dtd
@@ -0,0 +1,89 @@
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/dtd/mirrors.dtd,v 1.3 2009/12/03 09:43:39 robbat2 Exp $ -->
+<!-- This file is used for keeping the new mirrors.xml file -->
+
+<!--
+ element: mirrors
+ description: A set of mirrorgroups followed by a list of countries with their code
+ example: <mirrors>
+ <mirrorgroup country="US" region="North America">
+ ...
+ </mirrorgroup>
+ ...
+ <countries>
+ <country code="CA">Canada</country>
+ ...
+ </countries>
+ </mirrors>
+-->
+
+<!ELEMENT mirrors (mirrorgroup*, countries)>
+
+<!--
+ element: mirrorgroup
+ description: Group mirrors by region and country.
+ The country code must exist in //countries/country
+ example: <mirrorgroup region="South America" country="BZ">
+ <mirror>
+ ...
+ </mirror>
+ ...
+ </mirrorgroup
+-->
+
+<!ELEMENT mirrorgroup (mirror*)>
+<!ATTLIST mirrorgroup region CDATA #REQUIRED
+ country IDREF #REQUIRED>
+<!--
+ element: mirror
+ description: One per mirror; name the mirror and provide one or more uris
+ optionally: provide GPS coordinates, a city and a bug id.
+ example: <mirror city="Corvallis"
+ coordinates="44.5646,-123.2620"
+ gentoo-bug="12345">
+ <name>OSU Open Source Lab</name>
+ <uri protocol="http">http://gentoo.osuosl.org/</uri>
+ <uri protocol="ftp">ftp://gentoo.osuosl.org/</uri>
+ </mirror>
+-->
+<!ELEMENT mirror (name, uri+)>
+<!ATTLIST mirror
+ city CDATA #IMPLIED
+ coordinates CDATA #IMPLIED
+ gentoo-bug CDATA #IMPLIED>
+
+<!--
+ element: name
+ description: Name of the mirror
+ note: Do not include a country and protocol pair, "(USA/http)" as they will
+ be built by the XSL.
+ example: <name>OSU Open Source Lab</name>
+-->
+<!ELEMENT name (#PCDATA)>
+
+<!--
+ element: uri
+ description: A Uniform Resource Locator for a given mirror
+ example: <uri protocol='http' ipv4='y' ipv6='y'>http://gentoo.osuosl.org/</uri>
+-->
+<!ELEMENT uri (#PCDATA)>
+<!ATTLIST uri ipv4 (Y|y|N|n) "y"
+ ipv6 (Y|y|N|n) "n"
+ partial (Y|y|N|n) "n"
+ protocol (http|ftp|rsync) "http">
+
+<!--
+ element: countries
+ description: A list of countries with their code and name
+ example: <countries>
+ <country code="CA">Canada</country>
+ <countries>
+-->
+<!ELEMENT countries (country*)>
+
+<!--
+ element: country
+ description: A country with its code
+ example: <country code="CA">Canada</country>
+-->
+<!ELEMENT country (#PCDATA)>
+<!ATTLIST country code ID #REQUIRED>