[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [oslc-promcode] Re: Fw: [oslc-core] Specification authoring tools + usage of vocabs and shapes
Arthur and Steve, Thank you for forwarding the email. It is a very good news for me. I summed up my approach at [1]. It only reduces the cost of writing HTML. However, the consistency between Turtle block and table written in Markdown needs to be verified by human(yes, just a little bit easier than before because they are in the same file). This means editing on them are easier than before, but we still have risk to make inconsistent document. In your approach, tables are automatically generated. This means no risk left, but still need to write some HTML or wiki. So I think in our PROMCODE TC, we can combine them as: (1)writing documents in Markdown, (2) and generate tables and Turtle block from Turtle file to HTML, (3) then combine them. At least, Turtle files and Markdown files should be version controlled in this case. I will try this next time. [1] https://wiki.oasis-open.org/oslc-promcode/shape/readme -- Kaz -----Original Message----- From: oslc-promcode@lists.oasis-open.org [mailto:oslc-promcode@lists.oasis-open.org] On Behalf Of Arthur Ryman Sent: Thursday, November 27, 2014 4:40 AM To: Steve K Speicher; oslc-promcode@lists.oasis-open.org Subject: [oslc-promcode] Re: Fw: [oslc-core] Specification authoring tools + usage of vocabs and shapes Steve, Thx for the pointer. This looks like it will be useful when it comes time to producing the OASIS specification. fyi, Kaz has been using Markdown, pandoc, and doclit to generate Turtle and HTML. This partially overlaps with your tool. We could still use your tool to generate HTML tables within the overall specification. I've asked Kaz to create a writeup of his approach. _________________________________________________________ Arthur Ryman Chief Data Officer SWG | Rational 905.413.3077 (phone) | 416.939.5063 (cell) IBM InterConnect 2015 From: Steve K Speicher/Raleigh/IBM@IBMUS To: Arthur Ryman/Toronto/IBM@IBMCA Date: 11/25/2014 05:32 PM Subject: Fw: [oslc-core] Specification authoring tools + usage of vocabs and shapes This post to the PROMCODE list failed. I think it has to do with me being an observer and not a member of the list. Anyway, if you don't mind please forwarding to the list and interested in your feedback as well on this. ----- Forwarded by Steve K Speicher/Raleigh/IBM on 11/25/2014 05:31 PM ----- From: Steve K Speicher/Raleigh/IBM To: oslc-promcode@lists.oasis-open.org Date: 11/25/2014 05:17 PM Subject: Fw: [oslc-core] Specification authoring tools + usage of vocabs and shapes Hopefully your TC could find this tool as useful. It is fairly limited on documentation of the extensions currently provided, I've been trying to keep the template spec complete with all the new features. ----- Forwarded by Steve K Speicher/Raleigh/IBM on 11/25/2014 05:15 PM ----- From: Steve K Speicher/Raleigh/IBM@IBMUS To: "OASIS OSLC Core TC Discussion List" <oslc-core@lists.oasis-open.org> Date: 11/25/2014 05:13 PM Subject: [oslc-core] Specification authoring tools + usage of vocabs and shapes Sent by: <oslc-core@lists.oasis-open.org> For some time and in various WGs, we've discussed whether certain items are considered "spec" or not. It also has been desired to limit the amount of specification development we need to do, so we've done some work in the past to automate generation of human readable HTML tables from things such as OSLC Resource Shapes. I've completed some initial work (some more to do), that shows promise in automating this. So I wanted to share the progress with you. Take for example this sample specification, namely these 2 sections: Shapes : http://sspeiche.github.io/respec/examples/oslc/template-spec.html#shape Vocabulary : http://sspeiche.github.io/respec/examples/oslc/template-spec.html#rdf-vocabu lary To enable the first, all that is needed is to include the OASIS version of ReSpec and this bit of HTML: <div title='RDF Shape for Template' data-include='./template-spec-shape.ttl' data-oninclude='shapeToSpec' data-include-sync='true' data-include-replace='true' data-include-format='html'></div> and obviously provide the shape in Turtle format. Likewise for vocabulary definition, you can just do: <div title='RDF Vocabulary for Template' data-include='./template-spec-vocab.ttl' data-oninclude='vocabToSpec' data-include-sync='true' data-include-replace='true' data-include-format='html'></div> This gives us great flexibility in being able to change the template and generation of the HTML without needing to go touch every spec under development. Note, when we are ready to publish a document through the OASIS publication process it will be transformed to raw HTML and scripts removed. I've already started to use this in real specs and is looking to be a great aide http://tools.oasis-open.org/version-control/browse/wsvn/oslc-core/specs/atta chments-v3.html#resources Feedback welcome (positive, problems, ideas to make it better) Not welcoming criticism of my JS skills, well maybe on a different thread. Thanks, Steve Speicher IBM Rational Software OSLC - Lifecycle integration inspired by the web -> http://open-services.net --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
Attachment:
smime.p7s
Description: S/MIME cryptographic signature
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]