Support for Markdown Authoring?
Now that I'm doing a lot of work with GitHub repos I'm writing a lot of markdown documents (readmes, wiki pages, etc.). Oxygen doesn't appear to have any out-of-the-box knowledge of markdown as a file type. I realize markdown files are fundamentally just text, but it would be nice if ".md" files were at least recognized as markdown files and there as a built-in file->new type of markdown. Cheers, E. ————— Eliot Kimber, Owner Contrext, LLC http://contrext.com
Hey Eliot, has anyone ever made a DITA to Markdown transform? It seems like that might be useful. I know it feels like going the opposite direction, but it would help make content connect into some of these developer tools. Tom --------------------- 801-822-2241 blog: idratherbewriting.com twitter: tomjohnson On Sat, Oct 11, 2014 at 7:33 AM, Eliot Kimber <ekimber@contrext.com> wrote:
Now that I'm doing a lot of work with GitHub repos I'm writing a lot of markdown documents (readmes, wiki pages, etc.).
Oxygen doesn't appear to have any out-of-the-box knowledge of markdown as a file type.
I realize markdown files are fundamentally just text, but it would be nice if ".md" files were at least recognized as markdown files and there as a built-in file->new type of markdown.
Cheers,
E. ————— Eliot Kimber, Owner Contrext, LLC http://contrext.com
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com http://www.oxygenxml.com/mailman/listinfo/oxygen-user
Hi Eliot, (resent to include the list address) What will be the support you will expect apart from knowing the extension and having a new file template? Both of these I think can be configured right now. I was thinking more along what Tom mentioned in his reply, to define a MarkdownML language and provide visual editing, specific actions and conversion to Markdown. Of course this can be done also as a DITA specialization or we can have MarkdownML to DITA transformations as well. Best Regards, George -- George Cristian Bina <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com On 11/10/14 17:33, Eliot Kimber wrote:
Now that I'm doing a lot of work with GitHub repos I'm writing a lot of markdown documents (readmes, wiki pages, etc.).
Oxygen doesn't appear to have any out-of-the-box knowledge of markdown as a file type.
I realize markdown files are fundamentally just text, but it would be nice if ".md" files were at least recognized as markdown files and there as a built-in file->new type of markdown.
Cheers,
E. ————— Eliot Kimber, Owner Contrext, LLC http://contrext.com
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com http://www.oxygenxml.com/mailman/listinfo/oxygen-user
In the OASIS Lightweight DITA Subcommittee we are currently working toward exactly something like this, a standard transform between Markdown and DITA. And between HTML5 and DITA, Word and DITA etc. We're just getting started but the DITA side will be a stripped-down but still conforming DITA. Mark Giffin Mark Giffin Consulting, Inc. http://markgiffin.com/ On 10/11/14 10:16 AM, George Bina wrote:
Hi Eliot,
(resent to include the list address) What will be the support you will expect apart from knowing the extension and having a new file template? Both of these I think can be configured right now.
I was thinking more along what Tom mentioned in his reply, to define a MarkdownML language and provide visual editing, specific actions and conversion to Markdown. Of course this can be done also as a DITA specialization or we can have MarkdownML to DITA transformations as well.
Best Regards, George -- George Cristian Bina <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com
On 11/10/14 17:33, Eliot Kimber wrote:
Now that I'm doing a lot of work with GitHub repos I'm writing a lot of markdown documents (readmes, wiki pages, etc.).
Oxygen doesn't appear to have any out-of-the-box knowledge of markdown as a file type.
I realize markdown files are fundamentally just text, but it would be nice if ".md" files were at least recognized as markdown files and there as a built-in file->new type of markdown.
Cheers,
E. ————— Eliot Kimber, Owner Contrext, LLC http://contrext.com
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com http://www.oxygenxml.com/mailman/listinfo/oxygen-user
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com http://www.oxygenxml.com/mailman/listinfo/oxygen-user
Not to malign DITA in any way, but Markdown is, by nature, HTML, isn't it? I'd like to have a "syntax switcher" button that let me convert Markdown to HTML and vice-versa. (Just as I would like this for RELAX NG compact syntax <-> XML syntax; sure, I can use trang as an external tool with generate/convert schema, but it would be nice if I could just be looking at a schema, click a button, and see it in compact syntax, eh?)
(resent to include the list address) What will be the support you will expect apart from knowing the extension and having a new file template? Both of these I think can be configured right now.
I was thinking more along what Tom mentioned in his reply, to define a MarkdownML language and provide visual editing, specific actions and conversion to Markdown. Of course this can be done also as a DITA specialization or we can have MarkdownML to DITA transformations as well.
Hi Syd, Have you tried switching a Relax NG XML schema to Author mode? Best Regards, George -- George Cristian Bina <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com On 11/10/14 13:59, Syd Bauman wrote:
Not to malign DITA in any way, but Markdown is, by nature, HTML, isn't it?
I'd like to have a "syntax switcher" button that let me convert Markdown to HTML and vice-versa.
(Just as I would like this for RELAX NG compact syntax <-> XML syntax; sure, I can use trang as an external tool with generate/convert schema, but it would be nice if I could just be looking at a schema, click a button, and see it in compact syntax, eh?)
(resent to include the list address) What will be the support you will expect apart from knowing the extension and having a new file template? Both of these I think can be configured right now.
I was thinking more along what Tom mentioned in his reply, to define a MarkdownML language and provide visual editing, specific actions and conversion to Markdown. Of course this can be done also as a DITA specialization or we can have MarkdownML to DITA transformations as well.
oXygen-user mailing list oXygen-user@oxygenxml.com http://www.oxygenxml.com/mailman/listinfo/oxygen-user
Have you tried switching a Relax NG XML schema to Author mode?
Why on earth would I ... [tries it; giggles] ... Wow. You never cease to amaze me. Score one for SyncRO. Of course it isn't really the same. Very impressive, and quite cool, but not the same. (E.g., a search for a term won't find it when it occurs as the name of an attribute or element, because, I presume, it is generated by a "content: attr(name);" in the CSS -- or do you have a solution for that, too?) Nonetheless, this may be enough to get me to switch back to using oXygen Editor instead of oXygen Developer. Thank you.
Hi Syd, The best results are when you switch the Author mode to "No tags" by default is renders "Partial tags" that is some small markers appear for inline elements. This was an interesting experiment to try to see what the Author mode can do for schemas, so we implemented visual modes for XML Schema, Relax NG, Schematron and NVDL and we even support embedded Schematron in Relax NG or XML Schema. This was done when the Author mode was at its beginning so the CSS files are providing mainly a nice view of the schemas - and of course for Relax NG XML the nice view is the Compact syntax :). I remember there was one or two cases where I was not able to get the exact syntax but otherwise the Author view on Relax NG XML is identical to the compact syntax and it is a very quick way to see how the compact schema will look like without actually converting to RNC. It will be interesting to come back to these and see how we can leverage the new functionality added in Author, especially form controls, to create a new way to develop XML grammars. Back to your question, you are right, content from attributes is presented with the content property and that is not searchable in oXygen Author. Best Regards, George -- George Cristian Bina <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com On 11/10/14 17:10, Syd Bauman wrote:
Have you tried switching a Relax NG XML schema to Author mode?
Why on earth would I ... [tries it; giggles] ... Wow. You never cease to amaze me. Score one for SyncRO.
Of course it isn't really the same. Very impressive, and quite cool, but not the same. (E.g., a search for a term won't find it when it occurs as the name of an attribute or element, because, I presume, it is generated by a "content: attr(name);" in the CSS -- or do you have a solution for that, too?)
Nonetheless, this may be enough to get me to switch back to using oXygen Editor instead of oXygen Developer.
Thank you. _______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com http://www.oxygenxml.com/mailman/listinfo/oxygen-user
participants (5)
-
Eliot Kimber -
George Bina -
Mark Giffin -
Syd Bauman -
Tom Johnson