Difference between revisions of "Talk:Best Practices for TEI in Libraries"
(→Review ODDs and schemas derived from them: new info based on emails from Syd) |
(removed things completed long ago) |
||
| Line 1: | Line 1: | ||
| − | The following are | + | The following are things to do to the BP before making an official "release". There is a separate list of [[Future changes to Best Practices for TEI in Libraries]]. |
== Review ODDs and schemas derived from them == | == Review ODDs and schemas derived from them == | ||
| Line 6: | Line 6: | ||
For those of you who are not interested in wrestling with command-line `roma`<ref>Last I knew, the web `Roma` will not properly process the new ODD constructs, so cannot be used for these files. Using the command-line `roma` is not all that bad, though. And once you get the hang of it, it is ''much'' faster than using the web. For a complete set of instructions for installing command-line `roma` on Mac OS X (or GNU/Linux), see http://www.wwp.brown.edu/encoding/current/handouts/roma_CLI_MacOS_X.html . Note that (a) there is a known but small cart-before-the-horse problem in these instructions — I don’t remember what it is at the moment or I’d tell you; and (b) that URL will (hopefully) change later this month, but it will probably get re-directed. ([[User:Syd|Syd]]</ref>, there is a snapshot of the HTML documentation and schemas (both closed in RELAX NG and open in ISO Schematron) on the web. There is [http://tei.wwp.brown.edu/~syd/temp/TEI-Library-SIG/BP_files.html an easy-to-use list of the most important files] and [http://tei.wwp.brown.edu/~syd/temp/TEI-Library-SIG/BestPractices/ the entire list of files]. There is a lot of work to be done on these documents. Even after we find & fix errors, we need lots of examples for the tagdocs (examples in the element definitions to override the default ones from P5, many of which aren't valid according to the BP because they contain extra elements, are missing required attributes, etc.). | For those of you who are not interested in wrestling with command-line `roma`<ref>Last I knew, the web `Roma` will not properly process the new ODD constructs, so cannot be used for these files. Using the command-line `roma` is not all that bad, though. And once you get the hang of it, it is ''much'' faster than using the web. For a complete set of instructions for installing command-line `roma` on Mac OS X (or GNU/Linux), see http://www.wwp.brown.edu/encoding/current/handouts/roma_CLI_MacOS_X.html . Note that (a) there is a known but small cart-before-the-horse problem in these instructions — I don’t remember what it is at the moment or I’d tell you; and (b) that URL will (hopefully) change later this month, but it will probably get re-directed. ([[User:Syd|Syd]]</ref>, there is a snapshot of the HTML documentation and schemas (both closed in RELAX NG and open in ISO Schematron) on the web. There is [http://tei.wwp.brown.edu/~syd/temp/TEI-Library-SIG/BP_files.html an easy-to-use list of the most important files] and [http://tei.wwp.brown.edu/~syd/temp/TEI-Library-SIG/BestPractices/ the entire list of files]. There is a lot of work to be done on these documents. Even after we find & fix errors, we need lots of examples for the tagdocs (examples in the element definitions to override the default ones from P5, many of which aren't valid according to the BP because they contain extra elements, are missing required attributes, etc.). | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Acknowledgments == | == Acknowledgments == | ||
* May need to revise DLF thank you to something more onging if they continue ot provide support (under discussion) | * May need to revise DLF thank you to something more onging if they continue ot provide support (under discussion) | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Revision as of 16:48, 3 January 2011
The following are things to do to the BP before making an official "release". There is a separate list of Future changes to Best Practices for TEI in Libraries.
Review ODDs and schemas derived from them
The latest version of the Best Practices for TEI in Libraries document, now derived from source TEI ODD files, is available for review. I have moved all of the content from the wiki page to TEI source files, but there is still a lot of work to be done. Besides just plain copy editing and review of the document and thorough testing of the schemas, the generic TEI stylesheets are not really up to the task of making the documents easily readable. The source is maintained on GitHub. Anyone (in the world) can get a copy of the source files from there at any time. Any one of you that wishes to have write access needs to send Syd your GitHub user name and he’ll add you to the “contributors” list.
For those of you who are not interested in wrestling with command-line `roma`<ref>Last I knew, the web `Roma` will not properly process the new ODD constructs, so cannot be used for these files. Using the command-line `roma` is not all that bad, though. And once you get the hang of it, it is much faster than using the web. For a complete set of instructions for installing command-line `roma` on Mac OS X (or GNU/Linux), see http://www.wwp.brown.edu/encoding/current/handouts/roma_CLI_MacOS_X.html . Note that (a) there is a known but small cart-before-the-horse problem in these instructions — I don’t remember what it is at the moment or I’d tell you; and (b) that URL will (hopefully) change later this month, but it will probably get re-directed. (Syd</ref>, there is a snapshot of the HTML documentation and schemas (both closed in RELAX NG and open in ISO Schematron) on the web. There is an easy-to-use list of the most important files and the entire list of files. There is a lot of work to be done on these documents. Even after we find & fix errors, we need lots of examples for the tagdocs (examples in the element definitions to override the default ones from P5, many of which aren't valid according to the BP because they contain extra elements, are missing required attributes, etc.).
Acknowledgments
- May need to revise DLF thank you to something more onging if they continue ot provide support (under discussion)
