GitXplorerGitXplorer
d

QtDocTools

public
3 stars
0 forks
13 issues

Commits

List of commits on branch master.
Unverified
408040167f19fef8c9d0959948498b20cda34ac6

Allow disabling all output from Saxon.

ddourouc05 committed 22 days ago
Unverified
18ffce4eb13d49759422f4effc2c52cecc60a4b5

Fix new lines in regexes.

ddourouc05 committed 23 days ago
Unverified
f13ea16990fee05791569cfca8ed883529690118

Fix typos.

ddourouc05 committed 23 days ago
Unverified
e06ce0fdbd25b4326d56e78516e0d63f0f8e158b

Code simplifications.

ddourouc05 committed 23 days ago
Unverified
e7ac63386d68d2318b7e9e9a3ea77ef8623048d3

Create a small FTP wrapper.

ddourouc05 committed 23 days ago
Unverified
95c3051704ac2f543c8cbeae3cad00f0394d7e05

Automate detection of Qt version when publishing from GitHub.

ddourouc05 committed 23 days ago

README

The README file for this repository.

A journey from QDoc 5/6 to DocBook

This tool works around the DocBook 5.2 format. It was first built to allow a more modern toolkit to work with Qt qdoc's generated output, and grew to offer many DocBook-related functionalities. Its capabilities:

  • Convert DocBook documents into DOCX and back.
  • Convert DocBook documents into ODT and back {WIP}.
  • Convert DocBook documents into DvpML (proprietary XML vocabulary used only by Developpez.com) and back (although the possibilities are more limited than with DOCX).
  • Run Developpez.com's proprietary tools to convert a document into HTML and upload it {WIP}.
  • Merge two versions of a document (either because it was proofread, and some metadata was lost, or because a new version of Qt was released and the existing documentation translation should be updated) {WIP}.
  • Run qdoc to generate Qt's documentation (requires qdoc 5.15, as it is the first version able to generate DocBook, but the later the better; 6.4 is a better minimum, 6.5+ should give the best results).

Repository organisation

Filters for most formats reside in the import and export folders, each within its own folder. These contain the XSLT stylesheets and possibly a few test cases. For transformations that do not rely on XSLT (like DOCX, using Apache POI), there are only tests.

The main code is in main_script.

The folder merge contains stuff about merging two documents. Its contents is in bad shape, right now.

Notes

Very useful tool to debug OOXML documents: the tools from the official SDK, v2.5 or the up-to-date SDK (validation only in C#, no desktop application)

CLI to get HTML from the wiki itself: https://www.dokuwiki.org/tips:dokuwiki_parser_cli. XML-RPC from a working wiki: https://www.dokuwiki.org/devel:xmlrpc. Pandoc supports DokuWiki dialect: https://pandoc.org/ (since 2.6)