#sphinx-doc

the indenting rules are insane, if i use a tab instead of spaces nothing works anymore

in index.rst

That sounds like a simple enough rule to me.

What use case do you have for mixing them?

i normally always use tabs, how is somebody supposed to know that in this particular document ONLY spaces are allowed to indent?

but I have a more pressing problem: I keep seeing very weird behavior with the toctree and document titles, if I click on my page defined by "demo.rst <demo>" the tree on the left suddenly shows the old version of the tree even after i do a complete deletion of the build folder

If you've already tried refreshing the page, try a refresh in your browser that clears your cache as well. I think it's either ctrl-f5 or shift-f5 in most browsers.

oh god you are right, sorry..

No worries.

hm it doesnt work for my other project, but for some reason in that project my chapters all have '1' in front of them

i mean the links on the left side, they all start with '1'

Odd.

nvm, it worked but the '1' is still there. I assume it's because I use the ==== marker

(i had to clean the build output though, that's a little annoying)

Hi, is it possible to plug a custom builder on sphinx?

Builder as in instead of make / Windows shell?

sdough, a builder to make a different result from a given .rst

sdough, looks like I'm looking for extensions

I can't get sphinx to use pygment's json lexer

(I registered it manually, but there must be a bug)

orbisvicis: Do you have a test case or any error/warning messages?

sdough: no messages. test-case is just: ".. code-block:: json" with pygments >= 1.5

Hrm.

orbisvicis: Is there already a bug filed?

doesn't appear so

so...

I'd suggest filing a bug with a test case attached.

thought so

ok

May I ask what you expect an empty code block to do? Should pygments give an empty box with the language listed or something?

sdough: ".. code-block:: json\n\n <json-data-here>"

where <json-data-here> can be just {}

orbisvicis: I get it rendering as <div class="highlight-json"><div class="highlight"><pre><span class="p">{}</span> - does does pygment do something different?

er, </pre></div> too

is it colored ?

Nope.

Should it be?

sdough: http://pygments.org/demo/1134486/

I get coloring on that.

Would you like a copy of my test case?

no need

You fixed it?

what? No, I have my own example that I'll inline to the issue.

sdough: that was just the pygments demo showing the appropriate coloring

the problem is that sphinx output has no colorouing, it should look like that demo

I get coloring in the Sphinx output when I drop that JSON into its input.

oh. yes, then your example would be helpful

hmm

ok, I am getting colouring now

Yay! What changed?

I deleted my browser's cache

not sure that makes sense, but it works now?

heh

ctrl-f5 is my friend when working with Sphinx.

orbisvicis: "p" is the right class for {}

I don't know if working with it under a web server versus direct filesystem access would help maybe?

it's Punctuation

and as you can see on the demo, it's not usually colored

birkenfeld: yes I screwed that up. but my original sphinx text included (http://pygments.org/demo/1134486/ + some extra json). I can only assume there was a syntax error in the extra leading to no highlighting, and when I fixed it the text remained uncoloured

until I deleted the cache

Hm, I'd hope that a syntax error would result in a warning.

Did it not?

sdough: not sure. I rebuilt several times without extra. there where no warnings, but there was also no colouring

I mean, I didn't check on first build for errors

Browser caching can be cruel. I assume many browsers have an option to disable it for web development purposes?

sdough: yeah, but ctrl-f5 should be good enough, thanks for that btw

Happy to help!

how can I show before/after code-blocks side-by-side ?

Other than manually align the blocks with whitespace? Do you know of diff extensions that might be able to apply on top of a code block?

sdough: what do you mean ?

(meanually align blocks with whitespace). I've only figured out how to do it with grid tables.

and the :diff option to literalinclude, which isn't really appropriate. Haven't found any extensions

orbisvicis: It's too ugly to seriously consider, but I mean combine the files and separate them by placing one file starting at column + 1 of the max column reached by the other.

yeah, I guess the best option would be to create a new rest directive

there are no good table-edit plugins for vim

actually, while reading the tutorial I find list-table, which fits perfectly

except for the bottom border display