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>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] On Fri, Jul 13, 2001 at 06:49:34PM -0700, Jon O . wrote: > Hello: > > A friend and I have written an article outlining how > to create a VPN between Checkpoint Firewall-1 and FreeBSD > using Kame and racoon. I've converted the article to the > standard FreeBSD html style for your review here: > > http://www.securityreports.com/vpn/index.html > > Please send me any feedback you have. 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 > how to create a VPN between FreeBSD and Windows 2000. > My understanding is that I should write any docs in SGML then > use a tool to convert to HTML (the FreeBSD HTML style). > Is this correct? 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-primer/ 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 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 make FORMAT=foo 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 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 -- 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 --- [-- Attachment #2 --] -----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-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010714111644.G35484>