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

Possible to create multiple projects from single repo? #1554

Closed
Swader opened this issue Aug 11, 2015 · 5 comments
Closed

Possible to create multiple projects from single repo? #1554

Swader opened this issue Aug 11, 2015 · 5 comments
Labels
Support Support question

Comments

@Swader
Copy link

Swader commented Aug 11, 2015

I have some Gettext translations all in a single repo, under /docs in my project. I can create a separate config file for every language, so that every language setup is essentially a translation of the original project, but is there a way to add multiple RTD projects via a single repository? I need this in order to not have to make a separate github repo for every one of the included languages - they have abstracted common parts and work fantastically in this single-repo setup, allowing all my users to update any language they see fit without leaving the repo. If I had to separate out all those languages into separate repos just to make new RTD projects and declare them as transactions, that'd be too much of a dealbreaker.

I saw some people did this, but I'm unclear on how they implemented it in RTD.

@ericholscher
Copy link
Member

You can point RTD to the specific conf.py file for Sphinx in the Advanced
Settings of the project Admin. This will use that specific conf.py,
allowing multiple projects that live in a repo.

We are hoping to add support for multiple translations within 1 project at
some point, but it's a low priority since it already works currently,
though it's a bit more effort.

On Tue, Aug 11, 2015 at 3:57 PM, Bruno Škvorc notifications@github.com
wrote:

I have some Gettext translations all in a single repo, under /docs in my
project. I can create a separate config file for every language, so that
every language setup is essentially a translation of the original project,
but is there a way to add multiple RTD projects via a single repository? I
need this in order to not have to make a separate github repo for every one
of the included languages - they have abstracted common parts and work
fantastically in this single-repo setup, allowing all my users to update
any language they see fit without leaving the repo. If I had to separate
out all those languages into separate repos just to make new RTD projects
and declare them as transactions, that'd be too much of a dealbreaker.

I saw some people did this
https://github.com/effektif/user-docs/tree/master/docs/de, but I'm
unclear on how they implemented it in RTD.


Reply to this email directly or view it on GitHub
#1554.

Eric Holscher
Maker of the internet residing in Portland, Oregon
http://ericholscher.com

@agjohnson agjohnson added the Support Support question label Aug 12, 2015
@Swader
Copy link
Author

Swader commented Aug 12, 2015

You can point RTD to the specific conf.py file for Sphinx in the Advanced
Settings of the project Admin. This will use that specific conf.py,
allowing multiple projects that live in a repo.

That was the original idea, yes, but as I can only set up one project from a single repo, I don't get the change to set up several projects, each pointing to its own conf.py. Or am I missing something.

@gregmuellegger
Copy link
Contributor

@Swader I think you can create a new project that uses the same repository url. You will have two distinct projects on RTD with different names that use the same repository.

@Swader
Copy link
Author

Swader commented Aug 19, 2015

Ah, correct. So that worked and I have everything running smoothly on my local machine.

My builds on RTD are failing, though - any help would be much appreciated.

It keeps looking for the master file in the location of the custom conf.py file, specific to the language. How do I make it look for the sources two folders above the current file's location? I tried appending paths, to no avail. See here or more specifically here for English and here for Croatian.

Full build error here.

@Swader
Copy link
Author

Swader commented Aug 20, 2015

Resolved via #1573 and in this project

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Support Support question
Projects
None yet
Development

No branches or pull requests

4 participants