Editing Synchronize Wiki with Docbook
From BRL-CAD
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 1: | Line 1: | ||
BRL-CAD has more than a million words of documentation (thousands of pages) in a variety of formats. We have a long-term goal to consolidate as much as possible into the Docbook format so that it can be more directly managed by our revision control system and integrated with the source code. At the same time, we have a user-editable wiki that is really easy for users and developers alike to keep up to date. The two, however, are not immediately compatible with one another. Data is not shared or synchronized. | BRL-CAD has more than a million words of documentation (thousands of pages) in a variety of formats. We have a long-term goal to consolidate as much as possible into the Docbook format so that it can be more directly managed by our revision control system and integrated with the source code. At the same time, we have a user-editable wiki that is really easy for users and developers alike to keep up to date. The two, however, are not immediately compatible with one another. Data is not shared or synchronized. | ||
| − | The main goal of this project would be to synchronize the two so that edits to either are reflected in the other without loss of data. One of the main challenges is how to retain the more expressive Docbook markup within | + | The main goal of this project would be to synchronize the two so that edits to either are reflected in the other without loss of data. One of the main challenges is how to retain the more expressive Docbook markup within MediaWiki so that edits via the wiki are not "dumbed down" to the more simple MediaWiki syntax. |
| − | The initial thoughts on our end are to implement a | + | The initial thoughts on our end are to implement a MediaWiki extension that understands how to translate to/from the Docbook format that faithfully preserves all Docbook tagging. You're welcome to suggest another approach. |
A great starting point for this project are our existing command sets for BRL-CAD and MGED (our main geometry editor). They respectively constitute approximately 400 and 700 commands that have a page of documentation each. | A great starting point for this project are our existing command sets for BRL-CAD and MGED (our main geometry editor). They respectively constitute approximately 400 and 700 commands that have a page of documentation each. | ||
| Line 17: | Line 17: | ||
* Basic familiarity with Docbook | * Basic familiarity with Docbook | ||
| − | * Basic familiarity with | + | * Basic familiarity with MediaWiki editing and/or MediaWiki extensions |
* Familiarity with web development technologies | * Familiarity with web development technologies | ||
* Basic familiarity with a revision control system (Subversion) | * Basic familiarity with a revision control system (Subversion) | ||
