Processing Documents for the LDP ================================ 1. Need an account on metalab.unc.edu. Contact Paul Jones (pjones@metalab.unc.edu) to establish one. 2. Create a work/holding area in which to process HOWTOs. 3. For HOWTOs coming in thru ldp-submit, copy up to the workarea. 4. If an update to an existing HOWTO, make sure the filename matches the existing HOWTO (or mini-HOWTO) *exactly* !! I usually check the available SGML archive areas for a name match. For example... If a "full" HOWTO: bash$ ls /pub/Linux/docs/HOWTO/other-formats/sgml/* bash$ ls /pub/Linux/docs/HOWTO/other-formats/docbook/* If a mini-HOWTO: bash$ ls /pub/Linux/docs/HOWTO/mini/other-formats/sgml/* bash$ ls /pub/Linux/docs/HOWTO/mini/other-formats/docbook/* 5. From the workarea, run the 'ldp_mk' script to produce all output formats for the HOWTO. Specify the SGML file name on cmd-line: bash$ /export/sunsite/users/gferg/toolroot/ldp_mk .sgml 6. From the workarea, run the 'ldp_cp' script to copy the various output formats into their respective areas on metalab. Specify the name of the HOWTO, sans any file extension, on cmd-line. If a "full" HOWTO: bash$ /export/sunsite/users/gferg/toolroot/ldp_cp If a mini-HOWTO: bash$ /export/sunsite/users/gferg/toolroot/ldp_cp_mini 7. Repeat 3-7 for as many new/updated HOWTOs as necessary. 8. Check the file into the CVS archive. You'll need to have your *own* CVS workarea established. You can figure out where the file belongs in the CVS archive (LDP/howto/{linuxdoc,docbook}). I always do a 'cvs update' first (in the directory where the new/updated HOWTO will be placed). Check-in a new file: bash$ cvs add -m "new entry" .sgml ... bash$ cvs commit -m "new entry" .sgml ... Check-in an update to an existing file: bash$ cvs ci -m "updated" .sgml ... 9. Send mail to ldp-announce@lists.linuxdoc.org From the workarea I do this: bash$ head *.txt Then copy/paste portions into an email, include URL for each, and send it out. 10. Update the HOWTO-INDEX: a. Update and grab the latest files from the CVS archive. Copy into a workarea: bash$ cvs update /LDP/howto/docbook/HOWTO-INDEX/ bash$ cp /LDP/howto/docbook/HOWTO-INDEX/*.sgml . b. Find out which chapters the HOWTO is reference in: bash$ grep '' *.sgml NOTE: One file will *always* be either miniChap.sgml or howtoChap.sgml c. Edit the file, change the "Updated:" date...if necessary. If new entry, add to the appropriate file/chapter. Use the summary info, etc. - *follow the existing format*! d. Publish the file: bash$ /export/sunsite/users/gferg/toolroot/ldp_mk HOWTO-INDEX.sgml bash$ /export/sunsite/users/gferg/toolroot/ldp_cp HOWTO-INDEX c. Check the file(s) back into the CVS archive: bash$ cp .sgml /LDP/howto/docbook/HOWTO-INDEX bash$ cd /LDP/howto/docbook/HOWTO-INDEX bash$ cvs ci -m "updated" .sgml 11. Update the "sorted HOWTOs" list: bash$ /export/sunsite/users/gferg/tools/mk_sortedht --- created : 22 June 2000 modified: 22 June 2000 Greg Ferguson (gferg@sgi.com)