Updated TEI Guidelines prose for documenting processing model
Hi TEI Simple list and TEI Council list, I've updated the prose of tei-pm.odd to be my suggested guidelines prose draft (incorporating many suggested changes from LouB), and regenerated the html files associated with that. If you want to read them see: http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master... (for the --summaryDoc version or for the full odd version see) http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master... (with the caveat the htmlpreview.github.io sometimes seems to throw away the CSS, and sometimes it works fine *shrug*) Council should feel free to update, correct and modify the tei-pm.odd file should they spot typos or corrigible errors. -James -- Dr James Cummings, Academic IT Services, University of Oxford TEI Consultations: tei@it.ox.ac.uk
I've made a number of edits to the first 120 or so lines of tei-pm.odd in the way of suggested improvements to the prose, in a fresh branch: https://github.com/TEIC/TEI-Simple/tree/MDH_edits I think there's still quite a lot of polishing to be done here. I also tried to build Simple, but the tests failed: Validate Simple ODD against tei-pm RELAX NG [runjing] /home/mholmes/Documents/tei/Simple/xsimple.odd:292:29: error: element "title" not allowed here; expected the element end-tag or text and many more similar. Can anyone else build? Cheers, Martin On 2015-10-27 05:25 PM, James Cummings wrote:
Hi TEI Simple list and TEI Council list,
I've updated the prose of tei-pm.odd to be my suggested guidelines prose draft (incorporating many suggested changes from LouB), and regenerated the html files associated with that. If you want to read them see:
http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(for the --summaryDoc version or for the full odd version see) http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(with the caveat the htmlpreview.github.io sometimes seems to throw away the CSS, and sometimes it works fine *shrug*)
Council should feel free to update, correct and modify the tei-pm.odd file should they spot typos or corrigible errors.
-James
I agree -- I didnt manage to get even as far as the first 120 lines before deciding this needed more work than I could spare for the moment. When I do though, should I start a new branch for my revisions of your improved version? That seems a bit mad. Shouldn't we have just one "under development" branch? On 27/10/15 20:51, Martin Holmes wrote:
I've made a number of edits to the first 120 or so lines of tei-pm.odd in the way of suggested improvements to the prose, in a fresh branch:
https://github.com/TEIC/TEI-Simple/tree/MDH_edits
I think there's still quite a lot of polishing to be done here.
I also tried to build Simple, but the tests failed:
Validate Simple ODD against tei-pm RELAX NG [runjing] /home/mholmes/Documents/tei/Simple/xsimple.odd:292:29: error: element "title" not allowed here; expected the element end-tag or text
and many more similar. Can anyone else build?
Cheers, Martin
On 2015-10-27 05:25 PM, James Cummings wrote:
Hi TEI Simple list and TEI Council list,
I've updated the prose of tei-pm.odd to be my suggested guidelines prose draft (incorporating many suggested changes from LouB), and regenerated the html files associated with that. If you want to read them see:
http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(for the --summaryDoc version or for the full odd version see) http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(with the caveat the htmlpreview.github.io sometimes seems to throw away the CSS, and sometimes it works fine *shrug*)
Council should feel free to update, correct and modify the tei-pm.odd file should they spot typos or corrigible errors.
-James
I get the same validation errors as you. It looks like a namespace issue: onvdl isn't handling the examples namespace properly. On 27/10/15 21:10, Lou Burnard wrote:
I agree -- I didnt manage to get even as far as the first 120 lines before deciding this needed more work than I could spare for the moment. When I do though, should I start a new branch for my revisions of your improved version? That seems a bit mad. Shouldn't we have just one "under development" branch?
On 27/10/15 20:51, Martin Holmes wrote:
I've made a number of edits to the first 120 or so lines of tei-pm.odd in the way of suggested improvements to the prose, in a fresh branch:
https://github.com/TEIC/TEI-Simple/tree/MDH_edits
I think there's still quite a lot of polishing to be done here.
I also tried to build Simple, but the tests failed:
Validate Simple ODD against tei-pm RELAX NG [runjing] /home/mholmes/Documents/tei/Simple/xsimple.odd:292:29: error: element "title" not allowed here; expected the element end-tag or text
and many more similar. Can anyone else build?
Cheers, Martin
On 2015-10-27 05:25 PM, James Cummings wrote:
Hi TEI Simple list and TEI Council list,
I've updated the prose of tei-pm.odd to be my suggested guidelines prose draft (incorporating many suggested changes from LouB), and regenerated the html files associated with that. If you want to read them see:
http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(for the --summaryDoc version or for the full odd version see) http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(with the caveat the htmlpreview.github.io sometimes seems to throw away the CSS, and sometimes it works fine *shrug*)
Council should feel free to update, correct and modify the tei-pm.odd file should they spot typos or corrigible errors.
-James
I see the problem with proliferating branches. Should I rename my branch to "dev"? I'm a bit more of a guest in Simple than in TEI, so I felt like I should branch and perhaps make a pull request, but we could just turn this into dev for Simple. Cheers, Martin On 2015-10-27 10:10 PM, Lou Burnard wrote:
I agree -- I didnt manage to get even as far as the first 120 lines before deciding this needed more work than I could spare for the moment. When I do though, should I start a new branch for my revisions of your improved version? That seems a bit mad. Shouldn't we have just one "under development" branch?
On 27/10/15 20:51, Martin Holmes wrote:
I've made a number of edits to the first 120 or so lines of tei-pm.odd in the way of suggested improvements to the prose, in a fresh branch:
https://github.com/TEIC/TEI-Simple/tree/MDH_edits
I think there's still quite a lot of polishing to be done here.
I also tried to build Simple, but the tests failed:
Validate Simple ODD against tei-pm RELAX NG [runjing] /home/mholmes/Documents/tei/Simple/xsimple.odd:292:29: error: element "title" not allowed here; expected the element end-tag or text
and many more similar. Can anyone else build?
Cheers, Martin
On 2015-10-27 05:25 PM, James Cummings wrote:
Hi TEI Simple list and TEI Council list,
I've updated the prose of tei-pm.odd to be my suggested guidelines prose draft (incorporating many suggested changes from LouB), and regenerated the html files associated with that. If you want to read them see:
http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(for the --summaryDoc version or for the full odd version see) http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(with the caveat the htmlpreview.github.io sometimes seems to throw away the CSS, and sometimes it works fine *shrug*)
Council should feel free to update, correct and modify the tei-pm.odd file should they spot typos or corrigible errors.
-James
Hi both, Yes. I was having a problem with egXML and anyXML... I tried to fix it at one point but reverted all those attempts because it didn't seem to work. Re: corrections to prose. More than happy to get corrections to prose. As long as you are not changing schemaSpec then you shouldn't need to re-build simple. That does things with the tei-simple files, the 'pm' Makefile target will rebuild the processing model tests (with the errors you mention). None of those makefile targets do the conversion to html for which I just used teitohtml --odd --sampleDoc for the tei-pm.html (and no --sampleDoc for the large one). I would say to branch and edit tei-pm.odd, regenerate the html output, merge if needed to let us see it. (Can we htmlpreview.github.io a branch? presumably?) Almost all of Martin's changes seemed reasonable to me. Maybe we could give Martin a deadline by which to stop and merge back his branch and then Lou can take over? That would stop too many branches? -James On 27/10/15 22:55, Martin Holmes wrote:
I see the problem with proliferating branches. Should I rename my branch to "dev"? I'm a bit more of a guest in Simple than in TEI, so I felt like I should branch and perhaps make a pull request, but we could just turn this into dev for Simple.
Cheers, Martin
On 2015-10-27 10:10 PM, Lou Burnard wrote:
I agree -- I didnt manage to get even as far as the first 120 lines before deciding this needed more work than I could spare for the moment. When I do though, should I start a new branch for my revisions of your improved version? That seems a bit mad. Shouldn't we have just one "under development" branch?
On 27/10/15 20:51, Martin Holmes wrote:
I've made a number of edits to the first 120 or so lines of tei-pm.odd in the way of suggested improvements to the prose, in a fresh branch:
https://github.com/TEIC/TEI-Simple/tree/MDH_edits
I think there's still quite a lot of polishing to be done here.
I also tried to build Simple, but the tests failed:
Validate Simple ODD against tei-pm RELAX NG [runjing] /home/mholmes/Documents/tei/Simple/xsimple.odd:292:29: error: element "title" not allowed here; expected the element end-tag or text
and many more similar. Can anyone else build?
Cheers, Martin
On 2015-10-27 05:25 PM, James Cummings wrote:
Hi TEI Simple list and TEI Council list,
I've updated the prose of tei-pm.odd to be my suggested guidelines prose draft (incorporating many suggested changes from LouB), and regenerated the html files associated with that. If you want to read them see:
http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(for the --summaryDoc version or for the full odd version see) http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/master...
(with the caveat the htmlpreview.github.io sometimes seems to throw away the CSS, and sometimes it works fine *shrug*)
Council should feel free to update, correct and modify the tei-pm.odd file should they spot typos or corrigible errors.
-James
-- Dr James Cummings, James.Cummings@it.ox.ac.uk Academic IT Services, University of Oxford
participants (3)
-
James Cummings
-
Lou Burnard
-
Martin Holmes