From owner-freebsd-doc Sat Jul 14 3:21:13 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 45D6637B401 for ; Sat, 14 Jul 2001 03:21:09 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f6EAGiP93021; Sat, 14 Jul 2001 11:16:44 +0100 (BST) (envelope-from nik) Date: Sat, 14 Jul 2001 11:16:44 +0100 From: Nik Clayton To: "Jon O ." Cc: freebsd-doc@FreeBSD.ORG Subject: Re: New article on Firewall-1 and FreeBSD Message-ID: <20010714111644.G35484@clan.nothing-going-on.org> References: <20010713184933.B26470@networkcommand.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="OFj+1YLvsEfSXdCH" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010713184933.B26470@networkcommand.com>; from jono@microshaft.org on Fri, Jul 13, 2001 at 06:49:34PM -0700 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 --OFj+1YLvsEfSXdCH Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jul 13, 2001 at 06:49:34PM -0700, Jon O . wrote: > Hello: >=20 > A friend and I have written an article outlining how=20 > to create a VPN between Checkpoint Firewall-1 and FreeBSD=20 > using Kame and racoon. I've converted the article to the=20 > standard FreeBSD html style for your review here: >=20 > http://www.securityreports.com/vpn/index.html >=20 > Please send me any feedback you have.=20 Looks good. It's not an area I'm familiar with, so I can't say more than that :-) > Also, I have another article in the first stages outlining=20 > how to create a VPN between FreeBSD and Windows 2000.=20 > My understanding is that I should write any docs in SGML then > use a tool to convert to HTML (the FreeBSD HTML style).=20 > Is this correct?=20 Yes. By far the easiest way to do it is. 1. Install the docproj/ meta-port, as described in the Doc. Proj. Primer, at http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-prime= r/ 2. Get a local copy of the FreeBSD doc/ tree. Either use CVSup in "checkout" mode to do this, or get a full copy of the CVS repository locally. If you have the CVS repository locally then as a minimum you will need to checkout the doc/share, doc/en_US.ISO8859-1/share, and=20 doc/en_US.ISO8859-1/articles directories. 3. Place your document in a subdirectory of the articles/ directory, (perhaps vpn-w2k/) call it article.sgml, and give it a Makefile (which you can copy from any of the other articles). 4. Edit away. 5. To convert your document from DocBook to another format simply do =20 make FORMAT=3Dfoo where 'foo' is one of html, html-split, txt, ps, pdf, rtf, or pdb. 6. Submit article.sgml using send-pr. > The article listed above is in HTML > using another FreeBSD article as an example. I suppose > it can't be converted to SGML from HTML=20 I think there are mechanical converters around, but they tend to work best on big documents -- the Firewall 1 article isn't too big, so doing it manually should probably only take about 30 minutes. 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 --- --OFj+1YLvsEfSXdCH 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 iEYEARECAAYFAjtQHAwACgkQk6gHZCw343WjFACfZyJezbZ/udM11CGgAf/Th0Xc DSwAnAgwJ2a/Hc4+UJ9/Ky3KpmndD3+j =j1+P -----END PGP SIGNATURE----- --OFj+1YLvsEfSXdCH-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message