From owner-freebsd-www@FreeBSD.ORG Fri Sep 14 12:14:31 2012 Return-Path: Delivered-To: www@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id EDD10106566C; Fri, 14 Sep 2012 12:14:30 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 9FC6A8FC08; Fri, 14 Sep 2012 12:14:30 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 6507914E8143; Fri, 14 Sep 2012 14:14:29 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id wxNcaqPD0zVw; Fri, 14 Sep 2012 14:14:25 +0200 (CEST) Received: from [192.168.1.100] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 9B85114E8141; Fri, 14 Sep 2012 14:14:25 +0200 (CEST) Message-ID: <50531F9D.6060602@FreeBSD.org> Date: Fri, 14 Sep 2012 14:14:21 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:14.0) Gecko/20120713 Thunderbird/14.0 MIME-Version: 1.0 To: FBSD Doc project X-Enigmail-Version: 1.4.4 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doc-committers@FreeBSD.org, www@freebsd.org Subject: [HEADSUP] We are now using XML X-BeenThere: freebsd-www@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: FreeBSD Project Webmasters List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 14 Sep 2012 12:14:31 -0000 -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hello Folks, as announced before, the doc/www repository has been migrated to XML. The fdp-primer is partly updated but it will need a deeper rework. Files are not yet renamed to .xml and we are still using Jade but those will be changed in future phases. The most important things you should now to continue committing: - - As discussed, character entities have been converted to native text since they are not too useful nowadays. We can suppose document authors can properly display what they edit so character entities just make it more difficult to edit text. One exception is when you have to type foreign names or terms that contain characters not available in the context language. Apart from this, their use is discouraged. (If someone needs help with the conversion of uncommitted work, I can provide some scripts.) - - XML is a subset of SGML so in general, things look the same as they used to be but the syntax is stricter (and cleaner): always close your tags and quote your attributes. - - Use lowe cases id names. - - Do not include PSGML comments in files. With XML these are not useful any more and not everyone uses emacs. If you want some editor-specific configuration, please do it in a separate config file, not in XML comments. - - Parameter entities can only be used with XML in DTD context so they had to be moved to the .ent files. - - XSLT files are now based on share/sgml/xhtml.xsl. Please import and customize this instead of reproducing the whole set of header divs if you need dynamic pages. This will help us change the design if we organize a design contest that has recently been discussed. Regards, Gabor (on behalf of doceng@) -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (MingW32) Comment: Using GnuPG with Mozilla - http://www.enigmail.net/ iEYEARECAAYFAlBTH50ACgkQkC3QTyNzprE+hACgpBu243yGT9trhmE4pAmkNYyn 4FQAn3yDc74EG6wbmnh3peO90aaim0ra =7myy -----END PGP SIGNATURE-----