Hi Tim, > You might want consider using the messaging framework we developed for > InaSAFE. We used to use sphinx in the same way you do and struggled with it > a) being very large to include in the plugin and b) requiring two separate > translation workflows (Qt based and gettext based). The messaging package is > currently bundled in InaSAFE here: > > https://github.com/inasafe/inasafe/tree/develop/safe/messaging > > But we could probably easily hive it of to its own pip package. The usage > semantics allow for production of rich content which can be displaced in a > web widget or exported to standalone pages. For example we produce > http://manual.inasafe.org from the same code base we have in the plugin. Here > is a simple example of how you use it to make a help page for a dialog: > > https://github.com/inasafe/inasafe/blob/develop/safe/gui/tools/help/dock_help.py#L51 > > I would say the learning curve is not much higher than learning RsT and you > have the advantage of your code and documentation all being managed in one > place. I’d love to see this moved into QGIS core one day as I guess this is a > really common requirement for plugin authors (and core devs…).
oh, this sounds really good. I will have a look and try to dive in it. In the meanwhile I solved the issue not directly with sphinx but with a script that moves the images folder, removes the other ones and with sed -i I'm replacing the correct paths in the html files (thanks Tom for the hint) The ugly script is here (that's maybe my second time with bash so it's reeeealy ugly): https://github.com/ghtmtt/DataPlotly/blob/master/help/replace_script.sh Before with 2 languages the zip was 20 MB now with 3 languages is 16 MB. Each language weights around 3MB. I did not try to move also the _static folder in the same way I did for the _images one. I know it's not the cleanest solution but (for the moment but not forever ;) ) the problem seems solved. Thanks again Matteo _______________________________________________ QGIS-Developer mailing list [email protected] List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
