kashirin-alex opened a new pull request #2241:
URL: https://github.com/apache/thrift/pull/2241
**Added a Markdown Generator:**
generate documentations in 'markdown' format
_The main reason is that some builds break with markdown files that include
html._
The ```thrift --help``` is now with a generator 'markdown' option:
```bash
markdown (MARKDOWN):
suffix: Create files/links with/out 'md|html' default None
noescape: Do not escape with html-entities in doc text.
```
**Some Markdown Generator Results Available at:**
* a direct view of a 'md' files
-
https://github.com/kashirin-alex/swc-db/blob/master/src/thrift/swcdb/README.md
-
https://github.com/kashirin-alex/swc-db/tree/master/docs/use/thriftclient#the-swc-db-thrift-modules
* a view of docs-generators:
- mkdocs build -
https://swc-db.readthedocs.io/en/latest/use/thriftclient/
- GitHub Jekyll theme build -
https://kashirin-alex.github.io/swc-db/use/thriftclient/#the-swc-db-thrift-modules
Note:
_-- the t_markdown_generator.cc is mostly based on the t_html_generator.cc,
while both can be improved by using structured template for populating data by
the specific-structure_
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
