Menu ▾ ▴

#567 Version of Element C for TEI Simple

AMBER
open
nobody
None
5(default)
2015-08-12
2015-08-12
Martin Mueller
No

For the TEI Simple project it would be nice to have a version of the current Appendix C in the Guidelines that lists only the elements etc. that are valid in TEI Simple. I assume this is a relatively straightforward process, though I don't know how to do it. If somebody could do it or teach me how to do it I would be very grateful. I noticed that both jtei and TEI Lite have parts of Appendix C--i.e. the description of an element with examples but lack the summary table, which over the years I have found enormously useful.

Related

Feature Requests: #567

Discussion

  • Hugh A. Cayless

    Hugh A. Cayless - 2015-08-12

    It would be nice to be able to generate this kind of documentation of any ODD. Probably without the TEI Guidelines branding. This is presumably a Stylesheets FR though. I'll leave this open for a bit in case anyone else has comments, and then open a GitHub issue and close it. There may be a straightforward method for doing this already, in which case we just need a bit of documentation. The ability to generate "API Doc" for your own customized ODD would be a nice feature.

     

  • Martin Holmes

    Martin Holmes - 2015-08-12

    We could use this as an opportunity to investigate and document the relationship between the Guidelines rendering process and the processing of regular ODDs.

     

    • Sebastian Rahtz

      Sebastian Rahtz - 2015-08-12

      I am puzzled
      This is standard behaviour of odd to html, surely?

      Sent from my iPhone

      On 12 Aug 2015, at 16:42, Martin Holmes martindholmes@users.sf.netamp#109;amp#97;amp#114;amp#116;amp#105;amp#110;amp#100;amp#104;amp#111;amp#108;amp#109;amp#101;amp#115;amp#64;amp#117;amp#115;amp#101;amp#114;amp#115;amp#46;amp#115;amp#102;amp#46;amp#110;amp#101;amp#116; wrote:

      We could use this as an opportunity to investigate and document the relationship between the Guidelines rendering process and the processing of regular ODDs.

      [feature-requests:#567]http://sourceforge.net/p/tei/feature-requests/567/ Version of Element C for TEI Simple

      Status: open
      Group: AMBER
      Created: Wed Aug 12, 2015 01:04 PM UTC by Martin Mueller
      Last Updated: Wed Aug 12, 2015 03:38 PM UTC
      Owner: nobody

      For the TEI Simple project it would be nice to have a version of the current Appendix C in the Guidelines that lists only the elements etc. that are valid in TEI Simple. I assume this is a relatively straightforward process, though I don't know how to do it. If somebody could do it or teach me how to do it I would be very grateful. I noticed that both jtei and TEI Lite have parts of Appendix C--i.e. the description of an element with examples but lack the summary table, which over the years I have found enormously useful.

      Sent from sourceforge.nethttp://sourceforge.net because you indicated interest in https://sourceforge.net/p/tei/feature-requests/567/

      To unsubscribe from further messages, please visit https://sourceforge.net/auth/subscriptions/

       

      Related

      Feature Requests: #567

      alternate

      • Hugh A. Cayless

        Hugh A. Cayless - 2015-08-12

        Very likely. I don't know the half of what your brilliant stylesheets do :-)

        Sent from my phone.

        On Aug 12, 2015, at 13:28, Sebastian Rahtz rahtz@users.sf.net wrote:

        I am puzzled
        This is standard behaviour of odd to html, surely?

        Sent from my iPhone

        On 12 Aug 2015, at 16:42, Martin Holmes martindholmes@users.sf.netmartindholmes@users.sf.net wrote:

        We could use this as an opportunity to investigate and document the relationship between the Guidelines rendering process and the processing of regular ODDs.

        [feature-requests:#567]http://sourceforge.net/p/tei/feature-requests/567/ Version of Element C for TEI Simple

        Status: open
        Group: AMBER
        Created: Wed Aug 12, 2015 01:04 PM UTC by Martin Mueller
        Last Updated: Wed Aug 12, 2015 03:38 PM UTC
        Owner: nobody

        For the TEI Simple project it would be nice to have a version of the current Appendix C in the Guidelines that lists only the elements etc. that are valid in TEI Simple. I assume this is a relatively straightforward process, though I don't know how to do it. If somebody could do it or teach me how to do it I would be very grateful. I noticed that both jtei and TEI Lite have parts of Appendix C--i.e. the description of an element with examples but lack the summary table, which over the years I have found enormously useful.

        Sent from sourceforge.nethttp://sourceforge.net because you indicated interest in https://sourceforge.net/p/tei/feature-requests/567/

        To unsubscribe from further messages, please visit https://sourceforge.net/auth/subscriptions/

        [feature-requests:#567] Version of Element C for TEI Simple

        Status: open
        Group: AMBER
        Created: Wed Aug 12, 2015 01:04 PM UTC by Martin Mueller
        Last Updated: Wed Aug 12, 2015 03:42 PM UTC
        Owner: nobody

        For the TEI Simple project it would be nice to have a version of the current Appendix C in the Guidelines that lists only the elements etc. that are valid in TEI Simple. I assume this is a relatively straightforward process, though I don't know how to do it. If somebody could do it or teach me how to do it I would be very grateful. I noticed that both jtei and TEI Lite have parts of Appendix C--i.e. the description of an element with examples but lack the summary table, which over the years I have found enormously useful.

        Sent from sourceforge.net because you indicated interest in https://sourceforge.net/p/tei/feature-requests/567/

        To unsubscribe from further messages, please visit https://sourceforge.net/auth/subscriptions/

         

        Related

        Feature Requests: #567

        alternate

  • James Cummings

    James Cummings - 2015-08-12

    I don't think you get a separate (or internal) equivalent to the REF-ELEMENTS.html page, which is what MartinM is suggesting should be available for any customisation. Improving the output for the odd to html so that there was a parameter to burst out the reference material into separate files (e.g. ref-p.html) and link to that from an equivalent of REF-ELEMENTS.html, which was linked to from the main output of the ODD (e.g. the local encoding documentation) would be a potential improvement.

    Specifically MartinM wants the list of elements by alphabet and by module with the little bit of javascript that helps you pick them. His use case is in trying to understand TEI Simple.

    All the logic to do so already exists in the Guidelines producing stylesheets, so it seems like it wouldn't be too difficult.

    If it already does exist, I've not found what parameter would enable it.

    -James

     

    • Sebastian Rahtz

      Sebastian Rahtz - 2015-08-13

      Conveptually simple. And the code exists

      But remember the default is to produce a single file - making multiple files adds complications
      Sebastian
      Sent from my iPhone

      On 12 Aug 2015, at 19:43, James Cummings jcummings@users.sf.netamp#106;amp#99;amp#117;amp#109;amp#109;amp#105;amp#110;amp#103;amp#115;amp#64;amp#117;amp#115;amp#101;amp#114;amp#115;amp#46;amp#115;amp#102;amp#46;amp#110;amp#101;amp#116; wrote:

      I don't think you get a separate (or internal) equivalent to the REF-ELEMENTS.html page, which is what MartinM is suggesting should be available for any customisation. Improving the output for the odd to html so that there was a parameter to burst out the reference material into separate files (e.g. ref-p.html) and link to that from an equivalent of REF-ELEMENTS.html, which was linked to from the main output of the ODD (e.g. the local encoding documentation) would be a potential improvement.

      Specifically MartinM wants the list of elements by alphabet and by module with the little bit of javascript that helps you pick them. His use case is in trying to understand TEI Simple.

      All the logic to do so already exists in the Guidelines producing stylesheets, so it seems like it wouldn't be too difficult.

      If it already does exist, I've not found what parameter would enable it.

      -James

      [feature-requests:#567]http://sourceforge.net/p/tei/feature-requests/567/ Version of Element C for TEI Simple

      Status: open
      Group: AMBER
      Created: Wed Aug 12, 2015 01:04 PM UTC by Martin Mueller
      Last Updated: Wed Aug 12, 2015 05:52 PM UTC
      Owner: nobody

      For the TEI Simple project it would be nice to have a version of the current Appendix C in the Guidelines that lists only the elements etc. that are valid in TEI Simple. I assume this is a relatively straightforward process, though I don't know how to do it. If somebody could do it or teach me how to do it I would be very grateful. I noticed that both jtei and TEI Lite have parts of Appendix C--i.e. the description of an element with examples but lack the summary table, which over the years I have found enormously useful.

      Sent from sourceforge.nethttp://sourceforge.net because you indicated interest in https://sourceforge.net/p/tei/feature-requests/567/

      To unsubscribe from further messages, please visit https://sourceforge.net/auth/subscriptions/

       

      Related

      Feature Requests: #567

      alternate
MongoDB Logo MongoDB