Date: Sat, 14 Jul 2001 11:16:44 +0100 From: Nik Clayton <nik@freebsd.org> To: "Jon O ." <jono@microshaft.org> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: New article on Firewall-1 and FreeBSD Message-ID: <20010714111644.G35484@clan.nothing-going-on.org> In-Reply-To: <20010713184933.B26470@networkcommand.com>; from jono@microshaft.org on Fri, Jul 13, 2001 at 06:49:34PM -0700 References: <20010713184933.B26470@networkcommand.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010714111644.G35484>