Compendium Code ArchivingTOC: No TOC in "Main.PaperCode" | ||||||||
| Changed: | ||||||||
| < < |
The Globalization Compendium currently resides on a server running Linux at McMaster. The operating environment of the server is detailed here. It receives TEI encoded articles from the Compendium editor. See Content section for more info on the document's pre-server life. This document describes the nature of the code itself and best practises for archiving it. | |||||||
| > > |
The Globalization Compendium currently resides on a server running Slackware Linux at McMaster. This server is pointed at from http://www.globalautonomy.ca. The Compendium is running on tapor1.mcmaster.ca. The operating environment of this server is detailed here. The Compendium user-facing process rovides information stored as TEI encoded XML and from data stored in a mySQL database. See Content section for more info on the document's pre-server life as it is turned into TEI-encoded XML docuemtns by a staff working for project editor. This document describes the process by which material is received from the editor and trsanformed into data for use by the Compendium. | |||||||
Adding Documents to the CompendiumThe way in which the data received is processed depends on the type of document being received. | ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
| ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
| ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
| ||||||||
| Changed: | ||||||||
| < < |
These are managed manually by the editor working with the system administrator. | |||||||
| > > |
| |||||||
| The code base for the Compendium exists as a collection of DTDs, XSL and Java routines that are bound to a series of frameworks for use with the Tomcat Servlet container. | ||||||||
| Added: | ||||||||
| > > |
| |||||||
OutputWhen a user requests a document from the Compendium... | ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
Best Archiving PractiseDocumentation | ||||||||
| Line: 44 to 51 | ||||||||
|---|---|---|---|---|---|---|---|---|
PrintingThe actual code developed for serving this should be committed to archival grade paper and filed along with the content locally at McMaster library as well as the National Library of Canada. Additionally the UML diagram and linked documentation of the system model should accompany this printed material.Digital Storage | ||||||||
| Changed: | ||||||||
| < < |
The source code itself will be committed... The Bibilographic database is currently contained in a MySQL? database and should be exported as a query file to allow for its replication. It should also be exported as an XML flatfile that would allow for its import into alternative data sources. | |||||||
| > > |
The source code itself will be committed via a tarball of the working directory as well as printout of the functions themselves. The Bibilographic and contributor database is currently contained in a MySQL? database and should be exported as a query file to allow for its replication. It should also be exported as an text flatfile that would allow for its import into alternative data sources. | |||||||
To Do | ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
Appendix | ||||||||
| Changed: | ||||||||
| < < |
-- ShawnDay - 19 May 2007 | |||||||
| > > |
-- ShawnDay - 6 June 2008 | |||||||
| ||||||||
Compendium Code ArchivingTOC: No TOC in "Main.PaperCode" | ||||||||
| Changed: | ||||||||
| < < |
The Globalization Compendium currently resides on a server running Linux at McMaster. It receives TEI encoded articles from the Compendium editor. See Content section for more info on the document's pre-server life. This document describes the nature of the code itself and best practises for archiving it. | |||||||
| > > |
The Globalization Compendium currently resides on a server running Linux at McMaster. The operating environment of the server is detailed here. It receives TEI encoded articles from the Compendium editor. See Content section for more info on the document's pre-server life. This document describes the nature of the code itself and best practises for archiving it. | |||||||
Adding Documents to the CompendiumThe way in which the data received is processed depends on the type of document being received. | ||||||||
| <<O>> Difference Topic PaperCode (r1.6 - 14 Aug 2007 - GeoffreyRockwell) |
Compendium Code Archiving | ||||||||
| Line: 47 to 47 | ||||||||
|---|---|---|---|---|---|---|---|---|
| The source code itself will be committed... The Bibilographic database is currently contained in a MySQL? database and should be exported as a query file to allow for its replication. It should also be exported as an XML flatfile that would allow for its import into alternative data sources. | ||||||||
| Added: | ||||||||
| > > |
To Do
| |||||||
Appendix | ||||||||
| <<O>> Difference Topic PaperCode (r1.5 - 24 May 2007 - GeoffreyRockwell) |
| ||||||||
| Added: | ||||||||
| > > |
Compendium Code Archiving | |||||||
| TOC: No TOC in "Main.PaperCode" The Globalization Compendium currently resides on a server running Linux at McMaster. It receives TEI encoded articles from the Compendium editor. See Content section for more info on the document's pre-server life. This document describes the nature of the code itself and best practises for archiving it. | ||||||||
| Line: 12 to 14 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
| ||||||||
| Line: 20 to 22 | ||||||||
| ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
OutputWhen a user requests a document from the Compendium... | ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
Best Archiving PractiseDocumentation![]() | ||||||||
| Changed: | ||||||||
| < < |
Best practises for code documentation specify that the lines of code be documented by the programmer. Ideally, this line by line documentation is written such that it can be compiled using a documentation generator such as JavaDoc? that can aggregate the inline documentation into and HTML or XML document to accompany the code proper. | |||||||
| > > |
Best practises for code documentation specify that the lines of code be documented by the programmer. Ideally, this line by line documentation is written such that it can be compiled using a documentation generator such as JavaDoc? that can aggregate the inline documentation into an HTML or XML document to accompany the code proper. | |||||||
| Additionally UML should be provided to abstract the Compendium as an object model. The individual objects in the UML should be linked to the actual code as developed. This can facilitate the sharing for the implicit logic of the code as written and also allow for cross propagation of the code base between alternate development environments. The technical specifications of the system should be compiled into a working document. Ideally this will also contain developer commentary to justify tool choices along with current version references, links to tool source code if possible. | ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
| TOC: No TOC in "Main.PaperCode" The Globalization Compendium currently resides on a server running Linux at McMaster. It receives TEI encoded articles from the Compendium editor. See Content section for more info on the document's pre-server life. This document describes the nature of the code itself and best practises for archiving it. | ||||||||
| ||||||||
| Changed: | ||||||||
| < < |
Input | |||||||
| > > |
Adding Documents to the Compendium | |||||||
The way in which the data received is processed depends on the type of document being received.
| ||||||||
| Added: | ||||||||
| > > |
| |||||||
| ||||||||
| Added: | ||||||||
| > > |
| |||||||
| ||||||||
| Added: | ||||||||
| > > |
| |||||||
The code base for the Compendium exists as a collection of DTDs, XSL and Java routines that are bound to a series of frameworks for use with the Tomcat Servlet container.
Output | ||||||||
| Added: | ||||||||
| > > |
When a user requests a document from the Compendium...
| |||||||
Best Archiving PractiseDocumentation | ||||||||
| Added: | ||||||||
| > > |
![]() | |||||||
| Best practises for code documentation specify that the lines of code be documented by the programmer. Ideally, this line by line documentation is written such that it can be compiled using a documentation generator such as JavaDoc? that can aggregate the inline documentation into and HTML or XML document to accompany the code proper. Additionally UML should be provided to abstract the Compendium as an object model. The individual objects in the UML should be linked to the actual code as developed. This can facilitate the sharing for the implicit logic of the code as written and also allow for cross propagation of the code base between alternate development environments. | ||||||||
| Line: 25 to 45 | ||||||||
|---|---|---|---|---|---|---|---|---|
| The source code itself will be committed... The Bibilographic database is currently contained in a MySQL? database and should be exported as a query file to allow for its replication. It should also be exported as an XML flatfile that would allow for its import into alternative data sources. | ||||||||
| Added: | ||||||||
| > > |
Appendix | |||||||
| -- ShawnDay - 19 May 2007 | ||||||||
| Added: | ||||||||
| > > |
| |||||||
| ||||||||
| Changed: | ||||||||
| < < |
The Globalization Compendium currently resides on a server. It receives TEI encoded articles from the Compendium editor. See Content section for more info on the document's pre-server life. This document describes the nature of the code itself and best practises for archiving it. | |||||||
| > > |
The Globalization Compendium currently resides on a server running Linux at McMaster. It receives TEI encoded articles from the Compendium editor. See Content section for more info on the document's pre-server life. This document describes the nature of the code itself and best practises for archiving it. | |||||||
InputThe way in which the data received is processed depends on the type of document being received. | ||||||||
| Changed: | ||||||||
| < < |
* If it is a research paper, position paper, or...it is .. | |||||||
| > > |
| |||||||
| * If it is a glossary entry,.. * If it is a bibliographic entry... | ||||||||
| Added: | ||||||||
| > > |
The code base for the Compendium exists as a collection of DTDs, XSL and Java routines that are bound to a series of frameworks for use with the Tomcat Servlet container. | |||||||
OutputBest Archiving Practise | ||||||||
| Added: | ||||||||
| > > |
DocumentationBest practises for code documentation specify that the lines of code be documented by the programmer. Ideally, this line by line documentation is written such that it can be compiled using a documentation generator such as JavaDoc? that can aggregate the inline documentation into and HTML or XML document to accompany the code proper. Additionally UML should be provided to abstract the Compendium as an object model. The individual objects in the UML should be linked to the actual code as developed. This can facilitate the sharing for the implicit logic of the code as written and also allow for cross propagation of the code base between alternate development environments. The technical specifications of the system should be compiled into a working document. Ideally this will also contain developer commentary to justify tool choices along with current version references, links to tool source code if possible. | |||||||
Printing | ||||||||
| Changed: | ||||||||
| < < |
The actual code developed for serving this should be committed to archival grade paper and filed along with the content locally at McMaster library as well as the National Library of Canada. Additionally the UML diagram of the structure of the system should accompany this printed material. | |||||||
| > > |
The actual code developed for serving this should be committed to archival grade paper and filed along with the content locally at McMaster library as well as the National Library of Canada. Additionally the UML diagram and linked documentation of the system model should accompany this printed material. | |||||||
Digital Storage | ||||||||
| Changed: | ||||||||
| < < |
The UML diagram of the codebase should refer to the specific files which will also be committed to archival quality DVD and filed with paper media above. | |||||||
| > > |
The source code itself will be committed... The Bibilographic database is currently contained in a MySQL? database and should be exported as a query file to allow for its replication. It should also be exported as an XML flatfile that would allow for its import into alternative data sources. | |||||||
| -- ShawnDay - 19 May 2007 | ||||||||
| Line: 1 to 1 | ||||||||
|---|---|---|---|---|---|---|---|---|
| Added: | ||||||||
| > > |
InputThe way in which the data received is processed depends on the type of document being received. * If it is a research paper, position paper, or...it is .. * If it is a glossary entry,.. * If it is a bibliographic entry...OutputBest Archiving PractisePrintingThe actual code developed for serving this should be committed to archival grade paper and filed along with the content locally at McMaster library as well as the National Library of Canada. Additionally the UML diagram of the structure of the system should accompany this printed material.Digital StorageThe UML diagram of the codebase should refer to the specific files which will also be committed to archival quality DVD and filed with paper media above. -- ShawnDay - 19 May 2007 | |||||||
|
Revision r1.1 - 19 May 2007 - 16:45 - ShawnDay Revision r1.8 - 06 Jun 2008 - 19:26 - ShawnDay |