1. This has been updated to include a chapter on Emacs and nXML Mode thanks to Gavin Henry, a few other patches/suggestion, and an Index. I also added some brief information on how the index is auto-generated. There are probably other minor fixes as well I can't remember. I have started tagging the files in CVS as I create new versions, so next time I can send out exact diffs for those interested and so you don't have to read it all again to figure out the subtle changes.
http://fedora.redhat.com/participate/documentation-guide/
2. I posted the latest version of the Fedora Jargon Buster. It is in CVS as well, so patches and suggestions are welcome. Thanks to Dave for starting it!
http://fedora.redhat.com/docs/jargon-buster/
3. I posted the beginnings of an FAQ for the Docs Project:
http://fedora.redhat.com/participate/documentation-faq/
I hope to start working on the Installation Guide and a "Quick Start" guide for getting started with the docs project this week as well.
Regards, Tammy
At 02:54 25/02/2004, Tammy Fox wrote:
I hope to start working on the Installation Guide and a "Quick Start" guide for getting started with the docs project this week as well.
<grin type="sad"/> Another documentation request please.
Fedora blew up on me last night, too slow with the up2date net responses. Never mind. Re-install was all I could think of.
I made a note of the steps to get back online after an idiot install, no options taken, then setting up the network to get web access via my setup.
I'll write it up, though it will need lots of alternatives for different kinds of net access. Mines 'dumb' insofar as it has fixed ip, router access to an adsl connection, so its probably the easiest one to configure!
article root element?
The bit I was missing, and DV from RH kindly gave me again. The url of the yum servers, to pick one that isn't quite as busy. http://fedora.redhat.com/download/mirrors.html
Or for others as senile as I -) http://fedora.redhat.com/ downloads mirrors
On Wed, 2004-02-25 at 07:39, Dave Pawson wrote:
At 02:54 25/02/2004, Tammy Fox wrote:
I hope to start working on the Installation Guide and a "Quick Start" guide for getting started with the docs project this week as well.
<grin type="sad"/> Another documentation request please.
Fedora blew up on me last night, too slow with the up2date net responses. Never mind. Re-install was all I could think of.
I made a note of the steps to get back online after an idiot install, no options taken, then setting up the network to get web access via my setup.
I'll write it up, though it will need lots of alternatives for different kinds of net access. Mines 'dumb' insofar as it has fixed ip, router access to an adsl connection, so its probably the easiest one to configure!
article root element?
or as a chapter. All Fedora docs should be articles except the Installation Guide, since it will be lengthy. What about adding this information as a chapter in a Troubleshooting section of the IG?
Tammy
The bit I was missing, and DV from RH kindly gave me again. The url of the yum servers, to pick one that isn't quite as busy. http://fedora.redhat.com/download/mirrors.html
Or for others as senile as I -) http://fedora.redhat.com/ downloads mirrors
At 15:18 25/02/2004, you wrote:
or as a chapter. All Fedora docs should be articles except the Installation Guide, since it will be lengthy. What about adding this information as a chapter in a Troubleshooting section of the IG?
ok, Will do, if I ever get up2date to work. No matter which server I choose, it hangs on the same file! I'm still running the 1.0 distro :-)
Wait till 2.0 is past beta before downloading?
regards DaveP
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On Wednesday 25 February 2004 02:54, Tammy Fox wrote:
- This has been updated to include a chapter on Emacs and nXML Mode
thanks to Gavin Henry, a few other patches/suggestion, and an Index. I also added some brief information on how the index is auto-generated. There are probably other minor fixes as well I can't remember. I have started tagging the files in CVS as I create new versions, so next time I can send out exact diffs for those interested and so you don't have to read it all again to figure out the subtle changes.
http://fedora.redhat.com/participate/documentation-guide/
- I posted the latest version of the Fedora Jargon Buster. It is in CVS
as well, so patches and suggestions are welcome. Thanks to Dave for starting it!
http://fedora.redhat.com/docs/jargon-buster/
- I posted the beginnings of an FAQ for the Docs Project:
http://fedora.redhat.com/participate/documentation-faq/
I hope to start working on the Installation Guide and a "Quick Start" guide for getting started with the docs project this week as well.
Regards, Tammy
Great!! I had been wondering when this would come out.
I am just about to read over the tutorial list and see what else I can do.
Can I just remind everyone that we have contributors section over on http://FedoraNEWS.ORG/contributors , so if anyone has some smaller howto's etc. that they feel should be included, or they want to release something now, rather than wait for it to be included in the docs project, just e-mail me and I will tag it up and post it.
Cheers.
- -- Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On Wednesday 25 February 2004 12:39, Dave Pawson wrote:
At 02:54 25/02/2004, Tammy Fox wrote:
I hope to start working on the Installation Guide and a "Quick Start" guide for getting started with the docs project this week as well.
<grin type="sad"/> Another documentation request please.
Fedora blew up on me last night, too slow with the up2date net responses. Never mind. Re-install was all I could think of.
If only you had seen :-)
http://fedoranews.org/tchung/howto/2003-11-15-yum-404.shtml
I made a note of the steps to get back online after an idiot install, no options taken, then setting up the network to get web access via my setup.
I'll write it up, though it will need lots of alternatives for different kinds of net access. Mines 'dumb' insofar as it has fixed ip, router access to an adsl connection, so its probably the easiest one to configure!
article root element?
The bit I was missing, and DV from RH kindly gave me again. The url of the yum servers, to pick one that isn't quite as busy. http://fedora.redhat.com/download/mirrors.html
Or for others as senile as I -) http://fedora.redhat.com/ downloads mirrors
- -- Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com
On Thu, 2004-02-26 at 11:13, Gavin Henry wrote:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On Wednesday 25 February 2004 02:54, Tammy Fox wrote:
- This has been updated to include a chapter on Emacs and nXML Mode
thanks to Gavin Henry, a few other patches/suggestion, and an Index. I also added some brief information on how the index is auto-generated. There are probably other minor fixes as well I can't remember. I have started tagging the files in CVS as I create new versions, so next time I can send out exact diffs for those interested and so you don't have to read it all again to figure out the subtle changes.
http://fedora.redhat.com/participate/documentation-guide/
- I posted the latest version of the Fedora Jargon Buster. It is in CVS
as well, so patches and suggestions are welcome. Thanks to Dave for starting it!
http://fedora.redhat.com/docs/jargon-buster/
- I posted the beginnings of an FAQ for the Docs Project:
http://fedora.redhat.com/participate/documentation-faq/
I hope to start working on the Installation Guide and a "Quick Start" guide for getting started with the docs project this week as well.
Regards, Tammy
Great!! I had been wondering when this would come out.
I am just about to read over the tutorial list and see what else I can do.
Can I just remind everyone that we have contributors section over on http://FedoraNEWS.ORG/contributors , so if anyone has some smaller howto's etc. that they feel should be included, or they want to release something now, rather than wait for it to be included in the docs project, just e-mail me and I will tag it up and post it.
Which brings up a good point...
A few people have asked if the howtos on fedoranews.org and the official Fedora docs projects could be combined. It seems like the goal is the same, but the files are on different servers and different formats. It would be ideal and easier on the people looking for information for all the inforamation to be in one location. Any thoughts?
Tammy
Cheers.
Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (GNU/Linux)
iD8DBQFAPhs1gNqd7Kng8UoRAsrzAJ9LGJqOByJ7IqdrflhVf3YZK0njnQCePOZC hnLfATJFgYB1OwDQ7jgWdcY= =2ID/ -----END PGP SIGNATURE-----
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Which brings up a good point...
A few people have asked if the howtos on fedoranews.org and the official Fedora docs projects could be combined. It seems like the goal is the same, but the files are on different servers and different formats. It would be ideal and easier on the people looking for information for all the inforamation to be in one location. Any thoughts?
Tammy
I think this might be good for the big ones, but I can't see how we can keep the fedora-docs ones as up-to-date, as we will need you to manual submit them via cvs etc.
I think this might be possible when redhat sorts out this kind of access, but until then it is much easier to up date our own.
We also have very diverse subjects. How would this be handled?
Maybe you could mirror us ;-)
What sort of politics would be involved with this anyway?
- -- Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com
At 16:16 26/02/2004, Gavin Henry wrote:
If only you had seen :-)
But you *are* planning to mark it as docbook.... :-) Arn't you Gavin?
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On Thursday 26 February 2004 17:18, Dave Pawson wrote:
At 16:16 26/02/2004, Gavin Henry wrote:
If only you had seen :-)
But you *are* planning to mark it as docbook.... :-) Arn't you Gavin?
If you would like ;-)
- -- Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
One last thing,
Since we use your css, is there anyway of tagging our howtos in such a way as too convert the html back to docbock?
They are written in html, but it is just a thought, as this would save converting the whole lot.
- -- Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com
At 22:56 26/02/2004, Gavin Henry wrote:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
One last thing,
Since we use your css, is there anyway of tagging our howtos in such a way as too convert the html back to docbock?
They are written in html, but it is just a thought, as this would save converting the whole lot.
<cringe>Write them in XML in the first place</cringe> Is this something about grandma and eggs?
That's why (some people) write in XML in the first place.
I'm trying not to sound 'told you so' ish. I don't think its working.
My only other suggestion is to chunk the source into tiny bits, then use a plain text to xml program, and chunk the big bits via some other progam into article or somesuch.
Tell me to go home Gavin... or suggest how we can help more usefully?
regards DaveP
On Fri, 2004-02-27 at 11:15, Dave Pawson wrote:
My only other suggestion is to chunk the source into tiny bits, then use a plain text to xml program, and chunk the big bits via some other progam into article or somesuch.
My I suggest html2db:
http://www.cise.ufl.edu/~ppadala/tidy/
It does a very nice, compliant conversion. Converting from HTML, it can't know much more than to turn <pre /> into <literal />, but that kind of thing is easy to fix. I've converted multi-page HTML into DocBook *ML in just a few hours with a simple convert and edit. The structure you get in the end is not the point, it's the chunks of markup which can then be put into a DocBook template.
Of course, it's nice to have an editor that can do e.g. sgml-tag-region and tag creation/completion for manually marking up missed or incorrect bits.
- Karsten
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
<cringe>Write them in XML in the first place</cringe> Is this something about grandma and eggs?
Aye, aye ;-)
That's why (some people) write in XML in the first place.
We never had that choice. Some are so small it would not be worth getting everyone to learn it. (not hard ;-) )
I'm trying not to sound 'told you so' ish. I don't think its working.
My only other suggestion is to chunk the source into tiny bits, then use a plain text to xml program, and chunk the big bits via some other progam into article or somesuch.
Tell me to go home Gavin... or suggest how we can help more usefully?
Go home... ;-)
Bigger ones like:
http://www.suretecsystems.com/docs/proxy-guide-en/index.html http://www.suretecsystems.com/docs/proxy-guide-en/proxy-guide-en.xml
I do, but the smaller ones, are sometimes easier to do the other way.
I am not too hot on xsl-stylesheets, although I did get the "Learning XML" O'reilly book for Christmas, but can you wirte one that sticks in some server-side-includes stuff. That would just be a variable to chuck on the end of each shtml file??
I do subscribe to: xsl-list@lists.mulberrytech.com
so I should know a little more. Oh, and I read your website :-)
Gavin.
- -- Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com
At 23:13 27/02/2004, Gavin Henry wrote:
We never had that choice. Some are so small it would not be worth getting everyone to learn it. (not hard ;-) )
Tell me to go home Gavin... or suggest how we can help more usefully?
Go home... ;-)
Bigger ones like:
http://www.suretecsystems.com/docs/proxy-guide-en/index.html http://www.suretecsystems.com/docs/proxy-guide-en/proxy-guide-en.xml
I do, but the smaller ones, are sometimes easier to do the other way.
I'm still a bit confused then, what is the other way you're referring to please? Or could I help with markup of the 'smaller' ones? (section/sect3 or whatever they are) for integration into a larger document? regards DaveP
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On Saturday 28 February 2004 13:25, Dave Pawson wrote:
At 23:13 27/02/2004, Gavin Henry wrote:
We never had that choice. Some are so small it would not be worth getting everyone to learn it. (not hard ;-) )
Tell me to go home Gavin... or suggest how we can help more usefully?
Go home... ;-)
Bigger ones like:
http://www.suretecsystems.com/docs/proxy-guide-en/index.html http://www.suretecsystems.com/docs/proxy-guide-en/proxy-guide-en.xml
I do, but the smaller ones, are sometimes easier to do the other way.
I'm still a bit confused then, what is the other way you're referring to please?
I meant the smaller howtos on Fedoranews.org. The proxy one is one I did for myself and another admin.
Or could I help with markup of the 'smaller' ones? (section/sect3 or whatever they are) for integration into a larger document?
Now I don't get this bit? ^^^^^^
- -- Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com
On Thu, 2004-02-26 at 17:56, Gavin Henry wrote:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
One last thing,
Since we use your css, is there anyway of tagging our howtos in such a way as too convert the html back to docbock?
They are written in html, but it is just a thought, as this would save converting the whole lot.
Well, if you can write a parsing script, there is always a way. If you are asking if I know of a way or have a script, then the answer is no. I've never had the need to go from HTML to DocBook thus far.
Tammy
Kind Regards, Gavin Henry.
http://www.magicfx.co.uk http://FedoraNEWS.ORG/ghenry http://www.suretecsystems.com -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (GNU/Linux)
iD8DBQFAPnmrgNqd7Kng8UoRAnRAAJ0esauTw4x6NYOYY7iZ0Db2vc0slwCg1mC2 rEISw3wezFUGIzbjthM1q/8= =lwXx -----END PGP SIGNATURE-----
At 22:04 01/03/2004, Tammy Fox wrote:
Well, if you can write a parsing script, there is always a way. If you are asking if I know of a way or have a script, then the answer is no. I've never had the need to go from HTML to DocBook thus far.
<grin/> You are in a minority Tammy.
There is more html out there than docbook! Honest.
regards DaveP
On Tue, 2004-03-02 at 12:30, Dave Pawson wrote:
At 22:04 01/03/2004, Tammy Fox wrote:
Well, if you can write a parsing script, there is always a way. If you are asking if I know of a way or have a script, then the answer is no. I've never had the need to go from HTML to DocBook thus far.
<grin/> You are in a minority Tammy.
There is more html out there than docbook! Honest.
regards DaveP
Sure. I don't doubt that. I, personally, have never had a big enough need. ;-)
Tammy
On Thu, 2004-02-26 at 14:56, Gavin Henry wrote:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
One last thing,
Since we use your css, is there anyway of tagging our howtos in such a way as too convert the html back to docbock?
They are written in html, but it is just a thought, as this would save converting the whole lot.
There are a couple of things out there that can do the conversion. I forget the names offhand, but they are in the archives of the LDP discuss and/or staff mailing list. Greg
On Wed, 2004-03-10 at 22:32, Gregory Leblanc wrote:
On Thu, 2004-02-26 at 14:56, Gavin Henry wrote:
They are written in html, but it is just a thought, as this would save converting the whole lot.
There are a couple of things out there that can do the conversion. I forget the names offhand, but they are in the archives of the LDP discuss and/or staff mailing list.
http://www.cise.ufl.edu/~ppadala/tidy/
html2db using TidyLib. I've used it multiple times, it works really well. It doesn't do tables, though. :)
What you get are mainly good containers, e.g. <para>, <section>, etc., and all the special cases are <literal> or <emphasis>, which are layout oriented instead of content oriented. But it's easy to fix ('C-c =' in pSGML mode will change the tag).
- Karsten
docs@lists.stg.fedoraproject.org
-
Dave Pawson -
Gavin Henry -
Gregory Leblanc -
Karsten Wade -
Tammy Fox