Skip to content
GitLab

Documentation temporary notes for the move to readthedocs · Changes

Page history
more notes: now playing on Rackspace... authored by pkra's avatar pkra
Hide whitespace changes
Inline Side-by-side
Documentation----temporary-notes-for-the-move-to-readthedocs.md
View page @ 08a521a8
......@@ -65,4 +65,27 @@ rm -rf "en/v1.0/.buildinfo"
gh-pages branch can be accessed via http://mathjax.github.com/mathjax-docs/en/latest/
That's more than we do right now, but not as much as the rtfd-badge gives... Will look if I can copy their design...
\ No newline at end of file
That's more than we do right now, but not as much as the rtfd-badge gives... Will look if I can copy their design...
### More notes.
So github is out of the race again for the temporary solution (i.e., until readthedocs upgrades their jquery). Simple reason: can't remap the DNS as we need to (b/c the mathjax.github.com is to become the main website's hosting point in the not-so-far future)
Way around it: use cloud files. Now that it's set up, this shouldn't be much work to maintain. Just use cyberduck to update what the above script produces.
It was a bit of a pain to set it up to though, so here are the notes for that -- the [rackspace docs](http://docs.rackspace.com/files/api/v1/cf-devguide/content/StaticWeb.html) aren't perfect, so I used [this blog post](http://www.garron.me/blog/host-static-site-cloud-files-rackspace-akamai-cdn.html), but even that misses one point. Anyway: to quote here the crucial paragraphs.
You need to send a POST message to your Storage-Url, with the header X-Container-Meta-Web-Index: index.html if your index page is index.html or any other you would prefer. For you to be able to send this message, and for it to be accepted, you first need to authenticate yourself. For the sake of clarity, let start with the complete example of the POST message you need to send, the complete message is (using curl):
``` curl -X POST -H "X-Container-Meta-Web-Index: index.html" -H "X-Auth-Token: aaaaaaaa-0000-0000-0000-aaaaaaaa" https://storage100.dcw1.clouddrive.com/v1/MossoCloudFS_1234567a-123c-12d1-7cad-a09878abcde3/your_container/ -v```
As you can see, you need something to put in X-Auth-Token field [Note from Peter: you also need the Storage URL], to get that value you have issue this other command in your Mac or Linux terminal:
curl -H "X-Auth-User: your-user-name" -H "X-Auth-Key: 0123456789abcdef01234567899d" https://auth.api.rackspacecloud.com/v1.0/ -v
Where:
* X-Auth-User: Is the username you use to log into your Rackspace account
* X-Auth-Key: Is your API key.