On www.FreeBSD.org there is are Apache config settings which overrides
/ports/INDEX, so the INDEX installed here isn't even used. On mirrors
it's just wasted bandwith since the file isn't used by anything (and
since for /usr/ports people will need INDEX-[567], for any recent
FreeBSD, people can't even use this INDEX file for anything useful).
- Move includes.nav*.sgml to share/sgml/navibar.ent and
<lang>/share/sgml/nabibar.l10n.ent.
- Move includes.sgml and includes.xsl to
share/sgml/common.ent, share/sgml/header.ent, <lang>/share/sgml/l10n.ent,
and <lang>?share/sgml/header.l10n.ent.
- Move most of XSLT libraries to share/sgml/*.xsl and
<lang>/share/sgml/*.xsl.
- Move news.xml and other *.xml files for the similar purpose
to share/sgml/*.xml and <lang>/share/sgml/*.xml.
- Switch to use a custom DTD for HTML document. Now we use
"-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension", which is
HTML 4.01 + some entities previously pulled via
"<!ENTITY % includes SYSTEM "includes.sgml"> %includes;" line.
The location of entity file will be resolved by using catalog file.
- Add DOCTYPE declearation to XML documents. This makes the followings
possible:
* Use of &foo; entities for SGML in an XML file instead of defining
{$foo} as the same content.
* &symbolic; entities for Latin characters.
- Duplicated information between SGML and XML, or English and
translated doc, has been removed as much as possible.
that aspect of the Ports Collection. Remove all the static text from
the portindex script and recast it into several SGML files that depend
on a common entity file. Add back the alphabetical list of categories
that was dropped in the last rework. Add many more references. Add
useful left-side selections.
Reviewed by: remko, pav, IONut, subdue, many others
No objection on: freebsd-www
into logical groups to make them easier to browse. Change some of the
wording near the Search block to make it clearer. Cleanup portindex to be
"use strict" and "-w" safe.
PRs: www/87500 (edwin, most of the work), www/45169 (linimon)
Approved by: silence on www
run tidy on these huge HTML files, and the files are valid HTML when
generated by portindex, even without tidy.
Running without tidy caused the build time to go from ~8 minutes to ~1
minute on my test machine. An additional bonus is that the generated
HTML files are now significantly smaller.
