From owner-freebsd-doc Wed Sep 26 5:22:26 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id BEA6437B40D for ; Wed, 26 Sep 2001 05:22:21 -0700 (PDT) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f8QBuq957981; Wed, 26 Sep 2001 12:56:52 +0100 (BST) (envelope-from nik) Date: Wed, 26 Sep 2001 12:56:52 +0100 From: Nik Clayton To: Jun Kuriyama Cc: doc@freebsd.org Subject: Re: Branching www/ for XML development Message-ID: <20010926125652.S31744@clan.nothing-going-on.org> References: <20010921001517.N1162@clan.nothing-going-on.org> <20010922113521.W1162@clan.nothing-going-on.org> <20010925173240.F31744@clan.nothing-going-on.org> <7m1ykud8oh.wl@waterblue.imgsrc.co.jp> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="l4+/aJnPlhOv5JVj" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <7m1ykud8oh.wl@waterblue.imgsrc.co.jp>; from kuriyama@imgsrc.co.jp on Wed, Sep 26, 2001 at 10:47:58AM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --l4+/aJnPlhOv5JVj Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Sep 26, 2001 at 10:47:58AM +0900, Jun Kuriyama wrote: > > Page layout > > ----------- >=20 > Is this toppage layout, or standard template for each pages? Standard template. =20 > If this is standard template, I think we should talk about whether we > need left/right navigation. IMHO these navigations narrow body area > and reduce readability of contents. The flip side of that is the argument that people find it easier to read text in narrower columns, because then their eyes don't have to flick back as far to the start of the next line. I've put up some test .html files at http://people.freebsd.org/~nik/xml-test/ index.html works, as will the links on the left hand side to "Project News" and "FreeBSD Press". Everything else is unlikely to work. There's no footer on any of the pages. There are all sorts of other problems. But it does show the look-and-feel on pages other than the index page. > > Page description language > > ------------------------- > >=20 > > To enforce the style guidelines, don't let authors write a complete HTML > > page. Instead, give them a cut-down markup language suitable for what = they > > need to do, allowing us to enforce the look and feel. >=20 > Do you think we can enforce our style guidelines to writers? =20 I think we have to. Looking over the existing site we have a mish-mash of different styles on different pages. > Defining > new schema may be overkill. My suggestion is using XHTML as base > schema and adding extentions for our local use. I'm a bit fuzzy on how that would work. Basically, I'd like authors to have control over two areas of the page: 1. The 'body copy'. 2. The selection of sidebars that appear on the right hand side. Everything else should be invisible to them. How would we do that using just XHTML? N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ FreeBSD Documentation Project http://www.freebsd.org/docproj/ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- --l4+/aJnPlhOv5JVj Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjuxwoQACgkQk6gHZCw343WC2QCdGoEeNnfaZmgSmjNmnYvoGnDj Vd0AniSyd/w8DMwcyi7DZBZYMf3j/a// =yfws -----END PGP SIGNATURE----- --l4+/aJnPlhOv5JVj-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message