same naming scheme as that used by the doc/ repo.
Update docs.sgml to point to the documentation in this canonical location.
Update the FAQ/ and handbook/ directories to use symlinks to point to
the real documentation under doc/en_US.ISO_8859-1/. This means that local
testing of the site (and mirrors) will still work as expected using the
legacy URLs. Mirrors that expect to see a lot of traffic are advised to
alter their web server configuration so that $WEBROOT/FAQ and $WEBROOT/handbook
are redirected to $WEBROOT/doc/en_US.ISO_8859-1/books/{faq,handbook},
instead of relying on the symlinks.
Discussed on: doc, www
Large URLs like
http://www.FreeBSD.ORG/docs/en_US.ISO_8859-1/books/handbook/
are evil and hard to use for humans. There is no reason to move
our handbooks 3 (!) directory levels deeper.
Also, docs did not build and too many things are now broken on the
web server. So I immediate back this nightmare out.
o Symbolic links for web.mk in each translations are removed.
o So building procedure is:
- cd /usr/www; make obj (optional)
- cd /usr/www/en; make all
Submitted by: nbm
Modified by: kuriyama
obj-clean.
This basically entails putting ${.CURDIR} in front of the occasional
source file, script, or directory.
Also adds '.include <bsd.obj.mk>' to web.mk so 'make obj' works.
Change gencommercial script to take a '-s' flag pointing to the source
directory, and the portindex script to take an optional additional
parameter indicating the source directory.
Add -D ${.CURDIR} to sgmlformat to follow includes properly.
automatically created from /usr/ports/INDEX and it does not make
sense to test the ports pages (Note: WEB_ONLY is a debug variable
for the webmaster, nothing else).
Made some changes when creating index.sgml from index.html.
* Changed element names to lower-case.
* Reindented.
* Quoted all attribute values.
* Added elements that are a good idea, but not strictly required (<tbody>)
* Reordered the two main columns. A new row has been added at the top,
and the second column (as it appears in a graphical browser) is in
this row. The left hand side bar is in the second row. Text browsers
should then display the main text first, with the quick links
afterwards. The display on graphical browsers should be almost identical
to how it was before.
Caveat: This forces the first line within the sidebar down by one.
* Removed <b>...</b> from the headings.
* Use &base; in many of the "href"s, instead of ".".
* <font size="4"> --> <big>
* <font size="2"> --> <small>
Approved by: Wolfram <wosch@freebsd.org>
This page documents, for those with accounts on the FreeBSD.org
network, just what machine resources are currently available and the
sorts of jobs they are being provided for.
Submitted by: jfieber
Newies", as she doesn't have the resources to continue hosting it -- it
also makes it easier for others to add to it as appropriate.
Update the Makefile to list the file, and support.sgml with the new link
to newbies.html.
This also marks my first commit since I was hit by RSI almost six weeks
ago. My appreciation to everyone in the FreeBSD community who wished me
well, and understood why I didn't immediately write back to them :-)
PR: docs/6386
Reviewed by: freebsd-doc
Submitted by: Sue Blake, <sue@welearn.com.au>
non-english web pages are not build.
This is basically a debug option. Most committers does not touch
the japanese documentation, so they don't need to test the
japanese files.
docproj.sgml, and added a new 'docproj' directory which contains other
project related .sgml files (and a Makefile). Updated the main Makefile to
include this new directory.
Reviewed by the various members of the -doc mailing list (including
John Fieber) over the past week or so.
clean up the build process a wee bit.
The basic change: instead of cheacking out bits and pieces of the
doc tree into the web build tree, check out the doc tree somewhere
else and put in a few symlinks from the web tree to the doc tree.
On catfish (soon to be hub) for example:
/usr/local/www/build/doc/...
/usr/local/www/build/www/...
where
/usr/local/www/build/www/data/handbook -> ../../doc/handbook
You have to manually put in the symlinks at the moment, but it
works better than the evil CVS hackery.
Also, install with -C to help avoid gratuitous cache-busting due to
gratuitous timestamp twiddling.