I've been using AsciiDocs to write all my documentation, and i was wondering if i could take it a step further and generate the html from my source code, like how JavaDoc does with Java source code.
For example, JavaDoc allows the developer to leave in-line comments that will later be used to generate the html documentation. Is this possible with AsciiDocs? Or do I just need to write the documentation separately?
Javadoc is somewhat modular and extensible: you can use a custom formatting syntax in javadoc comments if you generate the documentation with a custom "doclet".
For AsciiDoc, such a doclet already exists: https://github.com/asciidoctor/asciidoclet
Javadoc is specific to Java, if you use other programming languages there are other tools. Doxygen was created specially for C and C++ but it supports several programming languages and comment styles. For Python, there is pydoc. Whether there's a way to make these support AsciiDoc syntax, you'll have to investigate on your own.
I am curious to how browsers render xml in the presence of xsl? Is the html file generated an actual object? If so, is there a way to grab that html using Java Servlets, plain javascript, Nodejs or Expressjs?
Browsers have a built-in XSLT 1.0 processor which is invoked to transform the XML using the XSLT stylesheet. In some cases the built-in XSLT processor produces a DOM tree as output, in other cases it produces lexical HTML which is then parsed to construct a DOM.
If you want to perform the same operation on the server, there are plenty of XSLT processors available that you can invoke server-side. They come with an API that allows you to invoke the transformation, and in most cases they give you a range of options over how you want to capture the output, e.g. as an in-memory DOM (or DOM-like) tree, or as lexical XML or HTML.
Check what version of XSLT you want to use. The built-in processors in the browser only support XSLT 1.0, which is a rather ancient and restricted subset of the language; later versions (XSLT 2.0 and 3.0) have become much more powerful and user-friendly.
I need an example (in some console tool) to convert generated gtest XML report to HTML.
A solution mast be without using ant or Maven.
you should use xslt to transform xml into html.
you could use the xsltproc tool from the command line under linux. I guess there are equivalent tools for other OSes.
I did it for myself with programming language, which is Python 2.*: https://github.com/burlachenkok/gtest_report
Also this gtest_report supports comparision of 2 or more google test results.
If to be honest it was the prime goal.
How long have the MySQL XML functions like ExtractValue() and UpdateXML() been supported?
A rough version number will do.
5.1.5.
MySql 5.1 documentation Section 11.11 XML Functions
Beginning with MySQL 5.1.5, two functions providing basic XPath 1.0 (XML Path Language, version 1.0) capabilities are available. Some basic information about XPath syntax and usage is provided later in this section; however, an in-depth discussion...
I'm a LAMP web developer in Perl and at my current place we use some black magic in using Perl to retrieve the data, throw them into a XML and then pass the XML to an XSL file. And this is all handled magically by the almighty AxKit. Thus you can probably imagine that my XSL is full of XSLT lines, i.e. if test,#value etc.
I was wondering if there's any tool, IDE, etc which I can use to open the XSL file and check the HTML preview without having to modify anything in my current XSL?
I'm open for suggestions as long as it gets the job done. Thanks.
XSLT IDEs (Interactive Development Environments):
XSelerator (the one I've been using for 6-7 years). Free, has a Debugger for MSXML, has intellisense for both XSLT 1.0 and XSLT 2.0. In addition has some dynamic intellisense. The debugger has breakpoints, data breakpoints,visualizes temporary trees, variables, test conditions, current output, ..., etc.
VS2008 -- a good XML Editor + XSLT Debugger. Good static intellisence. Match patterns are statically checked. Breakpoints, data breakpoints, visualization of variables and the current output.
oXygen
XML-SPY (Altova)
Stylus Studio
XPath tools:
Update:
Both the IE and the FF versions of the XPath Visualizer have now a new, safe home, thanks to the hospitality of Lars Huttar. The links below point to the new, safe site.
The XPath Visualizer -- A popular IE-based tool for learning XPath and FF-based, too, by playing with XPath expressions. Free and open source. Allows any XPath expression to be evaluated against a given XML document and displayes the results hi-lighted in the xml document (if they are node(s)) or in a separate box (if the results are atomic values). Allows xsl:variable-s to be defined and then used in XPath expressions. Allows xsl:key-s to be defined and then referenced by key() functions within XPath expressions.
I am currently using Visual Studio, open your xml file within visual studio, from XML menu click show xslt output.
I found Stylus Studio to be an invaluable tool for all my XML needs. I never ran it rough Wine though.
I use cooktop which is free.
Try Microsoft XML Notepad
I'm using Visual Web Developer 2008 Express Edition...under my XML menu all I see is "Schemas..." when I have an XSL file open. Did I miss installing a component for the other options?
A couple of alternatives that haven't been mentioned, yet:
XML Copy Editor - Okay, but requires an intermediate step to generate HTML and then open HTML in an external browser.
WMHelp XMLPad - Many minor bugs and annoyances, but otherwise very useful: can review and debug transformations within the IDE.
I wrote a post describing these and a couple of other tools, in case someone is interested: How to test XSL transformations.