Date: Mon, 16 Jul 2001 22:57:17 +1000 From: "Haikal Saadh" <wyldephyre2@yahoo.com> To: "Nik Clayton" <nik@freebsd.org> Cc: <doc@freebsd.org> Subject: RE: New article on Firewall-1 and FreeBSD Message-ID: <PAELLGOEIMDLEJNEBOBOKEAPCDAA.wyldephyre2@yahoo.com> In-Reply-To: <20010714111644.G35484@clan.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Hi, I think this should go into the fdp primer, perhaps in an "Overview Section"? From reading just the primer, I was under the impression that I had to jump through numerous hoops before I could get a document up and running. Now that I see otherwise, I may actually give writing something a go. > -----Original Message----- > From: owner-freebsd-doc@FreeBSD.ORG > [mailto:owner-freebsd-doc@FreeBSD.ORG]On Behalf Of Nik Clayton > Sent: Saturday, 14 July 2001 8:17 PM > To: Jon O . > Cc: freebsd-doc@FreeBSD.ORG > Subject: Re: New article on Firewall-1 and FreeBSD > > > 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 --- > _________________________________________________________ Do You Yahoo!? Get your free @yahoo.com address at http://mail.yahoo.com 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?PAELLGOEIMDLEJNEBOBOKEAPCDAA.wyldephyre2>