资 源 简 介
What is it?
protoc-gen-docbook is a Protocol Buffers plugin for DocBook.
This project aims to support generating documentation in DocBook format with .proto source files. The DocBook format can then be converted to professional looking PDF through Apache FOP.
Why?
Although protobuf is an excellent data interchange format, it comes with very little documentation support. C-style comments within .proto, while useful for developers, does not scale well for large interfaces. Good-looking documentation is needed to enhance .proto readability and ease the pain of inter-file navigation.
Getting Started
See Quick Start Guide for more in
文 件 列 表
CHANGES.txt
deploy
!!Put your .proto files here and run.txt
docbook.properties
run.bat
example-addressbook
addressbook.proto
docbook.properties
run.bat
example-custom_template
custom_template.xml
docbook.properties
img
person.proto
run.bat
search_request.proto
search_response.proto
example-descriptor
descriptor.proto
docbook.properties
run.bat
example-unit_test
docbook.properties
google
run.bat
example-various_options
docbook.properties
run.bat
unittest.proto
unittest_import.proto
unittest_import_public.proto
fop-1.1
build
conf
docbook-xsl-1.78.0
docs
examples
fop
fop.bat
fop.cmd
fop.js
javadocs
KEYS
lib
LICENSE
NOTICE
README
status.xml
LICENSE.txt
protoc-gen-docbook.exe
protoc.exe
