instead of the PR form directly. Each user should read these
guidelines before sending a PR, but currently it seems they don't
do it always. We receive questions via PRs, which should be sent to
mailing lists instead, or PRs with not enough information and
rarely non-English PRs as well. I hope this will help a bit.
PR: www/97233
Submitted by: Gavin Atkinson <gavin@mod3.co.uk>
No objection from: freebsd-doc, freebsd-www, bugmeister
Approved by: keramida (mentor)
- 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.
the front/index page. See
http://www.freebsdfoundation.org/legal/guidelines.html for more
information.
- Remove XSL "copy" of $date variable since it's empty in index.xsl.
- Add a link the the FreeBSD trademark guidelines to the trademark
page.
Discussed with: FreeBSD Foundation
The parts of the front page which change often are not included in this
date so printing $FreeBSD$ doesn't buy us anything, it just gives the
impression that the content on the front page isn't updated as often as
it really is.
Discussed with: brueffer
Brought to you by: Crusade to keep front page as clutter free as
possible
much, and there's already "Report a Bug" link in Shortcuts area.
PR: www/87144 (inspired by)
Submitted by: Ivan Voras <ivoras@geri.cc.fer.hr>
Agreed on with: simon
- Convert 3 comments to uppercase, so they better match their recently
uppercase-converted counterparts (languagenav, frontnewscontent, frontnews).
- Fix 1 comment from FRONTNEWSEVENTS to FRONTEVENTSCONTENT.
PR: www/89382
Submitted by: Rudolf Cejka <cejkar@fit.vutbr.cz>
confusion.
Rationale: The ISO 8879 (SGML) specification defines this as
case-insensitive and it must always be treated as one in the upper case
when the SGML declaration does not include "NAMECASE GENERAL NO."
On the other hand, in the XML specification (REC-xml-20040204)
it is case-sensitive and no normalization with regard to the case
must not be performed by an XML parser. We use HTML 4.01 (SGML) DTD
in most of the files in the www tree and convert them into XHTML
1.0 (XML) DTD forcibly by using tidy. So, as long as we use both
SGML and XML DTD in this way it is better to use upper case only
for the id attribute to avoid the case sensitivity problem.
pages could really use some work as they don't do justice to the ports
collection, but I've been convinced this link is better than none.
Requested by: dozens
It looks like anchor references are case-sensitive (pretty obvious with
hindsight), so match the case here and in where.sgml.
Pointed out by: Pawel Worach on www@
New test "releases" should have their version numbers bumped in
share/sgml/includes.release.*, and the whole thing is easily
turn-off-and-on-able via knobs in the same files.
Discussed with: re (scottl)
don't first have to click through the 'Documentation' second level
page.
Make room for it by removing the link to the platforms page, which is
already linked to from another part of the front page.
Requested by: several on -www
can be found, i.e., http://www.FreeBSD.org/cgi at the moment.
This allows for easier pre-commit testing of CGI scripts, and avoids
SNAFUs with an incorrect URL being committed, as has happened a couple
of times recently.
en/ should be fully converted with this commit; other languages need to
be updated, but are in mid merge molasses at present so I have not
touched them.
news items and putting them into the localized web pages.
If the translation is available it will be used, otherwise
the original (English) version of the news item will be used.
FreeBSD. I can't reach the website right now, and Greg hasn't been
able to reach the guy making these statues. Last I heard no money was
ever received by the foundation from them in any case.
Discussed with: grog
believes it is in the best interest of the FreeBSD project and
community to have them listed in these places. This is tweaked
language from hrs@'s original commit, but also adds Pentium and Athlon
to the list of x86 platforms because they are the most popular.
Approved by: hrs, obrien, core
