Substance Composer Alpha 2 is out! Featuring DIY publishing through Github

[Michael Aufreiter]

Finally! :)

http://substance.io/diy-publishing-with-substance-and-github-pages/

Let me know how it works for you!

-- Michael

[Ian Mulvany]

Not working for me, 

I get either get an error message saying "could not create repository" when the repo exists, or "gh-pages is not set as the default branch"

[Oliver Buchtala]

Hey Ian!

thanks...
Did you try it with a new document? i.e., not with the about document but clicking the 'new' button?

Cheers,
Oliver

--
You received this message because you are subscribed to the Google Groups "Substance" group.
To unsubscribe from this group and stop receiving emails from it, send an email to substance_+...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

[Ian Mulvany]

I figured it out now, the default suggested "publications" repo already existed in my github account somehow, so I had to provide the name of a new repo, then it worked. 

https://github.com/IanMulvany/test-publications/

http://ianmulvany.github.io/test-publications/testing/

looking good so far! 

[Michael Aufreiter]

Hey Ian!

Can you describe the steps one by one again? I just tested different scenarios and it worked well for me on OSX Chrome 34. There are still rare cases where the Github API is flaky and drops some data. It would be very useful for us if you could inspect the repo on Github.. and let us know if there’s any files at all that made it through the wire.

Cheers.

—

Michael Aufreiter

Substance | http://substance.io

[Michael Aufreiter]

Whooh! Congrats! :) Now you have to draft your next blog post that way.

[Ian Mulvany]

this is the repo that was created on first run:

https://github.com/IanMulvany/publications

one thing here is in this instance I logged in to github using email & password.

This is where I was experiencing the errors listed above. No files seem to have made it over the wire. I think the error message on the substance app could be improved, it was only by chance that I tried inputting a new repo name in the interface.

I then logged in to github using username and password and I created the following repo via the substance interface: 

https://github.com/IanMulvany/test-publications

[Ian Mulvany]

Hmm, the github page seems to have gone awol now, I'm getting a 404 on http://ianmulvany.github.io/test-publications/testing/ 

[Michael Aufreiter]

Now that’s weird, but definitely a problem on Github’s end. Sometimes it takes a while until they trigger a page rebuild, however that a page disappeared after some time never happened to me.

You could try publishing a second doc under a different name, probably this retriggers the full page rebuild and the testing doc should come back…

Or just wait for another 20min.. could be a temporary problem.

—

Michael Aufreiter

Substance | http://substance.io

[Oliver Buchtala]

Hmmm... I had the same problem this afternoon.
That is definitely the GH rendering thing....
The only way to get out was unpublishing and repuplishing....

Alas! ;:p

[Michael Aufreiter]

Oh I think what happend is that since you unpublished (which triggers a page rebuild without the testing doc) a second rebuild hasn’t been done yet … i think the solution is just wait… but it’s good to be aware of that edge case.

the problem is that the github api only allows us to delete / upload one file at a time.. which correspond to one commit+push.. and bascially.. each of those ops.. trigger a rebuild.. which is not exactly efficient, and i guess github delays rebuilds in such a case. To solve the problem we’d need an API that allows batch updates.. this would also make things a lot faster. We were pitching that idea already to Github.

—

Michael Aufreiter

Substance | http://substance.io

[Oliver Buchtala]

I will implement a native solution one first :-p (for the native app)

[Ian Mulvany]

I've come back to have a look since yesterday, and the pages I created on github are still AWOL (http://ianmulvany.github.io/test-publications/testing/), so just waiting does not seem to solve the issue. 

I'd like to try to unpublished and republish, but I can no longer recall the original substance url that I started creating pages from. Is there any way for me to find docs that I've started?