Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Sphinx and graphviz to the docker image #161

Open
borsna opened this issue Aug 22, 2017 · 2 comments
Open

Add Sphinx and graphviz to the docker image #161

borsna opened this issue Aug 22, 2017 · 2 comments
Assignees
Labels
build build and release process
Milestone

Comments

@borsna
Copy link
Contributor

borsna commented Aug 22, 2017

You can assign me to this one.

To run Sphinx we need #38 and for Graphviz a fix for #160

@DanSmith DanSmith added this to the Backlog milestone Aug 22, 2017
@DanSmith
Copy link
Member

DanSmith commented Aug 22, 2017

We are thinking that we will have a build and deploy scripts which will be run by CI on commits and pull requests to a cogs model's repository. Something similar to the scripts in:

https://gitlab.com/c2metadata/sdtl-cogs/tree/master/build

We can still add it to the publisher also, but how would that look? Should we call sphinx-build directly with a bunch of arguments? Or a path to a user provided sphinx make file with just a sphinx target such as dirhtml?

@borsna
Copy link
Contributor Author

borsna commented Aug 22, 2017

I think keeping the makefile is the most flexible way to go.
Right now the makefile is generated by a build in template in cogs so adding additional output target from sphinx would not work.

If cogs check the Settings directory for a custom make-file when generating the Sphinx output rst-files additional targets and settings would be posible, if no file exist just do a default makefile.

The publish command would then just call the the makefile in the sphinx output directory specified via a path and also take additional arguments.

Dont know if this makes sense :)

@DanSmith DanSmith added build build and release process and removed enhancement labels Oct 3, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
build build and release process
Projects
None yet
Development

No branches or pull requests

2 participants