#pyramid

good evening

stevepiercy: is it to be currently expected that I get pyramid_cookbook/docs/automating_development_process/part3.rst:20: WARNING: Could not lex literal_block as "ini". Highlighting skipped. Makefile:40: recipe for target 'html' failed make: *** [html] Error 1 ?

stevepiercy: when I run make html on the pyramid cookbook

hello moo-_-

bind: do you have pygments installed?

bind: or might be wrong version of pygments

bind: let me try

bind: try pip install -U sphinx pygments

that might be a result of a recent update in Sphinx 1.3.5+ where it now emits warnings when source files or code is not in the format that the sphinx directive claims it to be

checking now...

I will try :)

also make html alone might not be enough

you might need that hairy bit of SPHINXBUILD=path to sphinxibuild

really... :D Will try that too

still does not help :/

;<

bind: http://pygments.org/docs/lexers/#pygments.lexer...

make sure that's on your virtualenv

try import from python shell

didn't know the sphinx is that hairy :D

bind: hairy as my balls

moo-_-: can't judge ... :D

when you build complex projects it becomes fragile

from pygments.lexers.configs import IniLexer gives me no troubles

bind it built for me with 15 warnings

bind: hmmm

bind: sure it uses sphinx from your virtualenv and not from system path?

bind including your error:

stevepiercy: well ... the problem is that I barely see any html in the _build directory (I guess that would be a good way to verify that my short gunicorn text is formatted right)

this:

crap

/Users/stevepiercy/projects/pyramid_cookbook/docs/automating_development_process/part3.rst:20: WARNING: Could not lex literal_block as "ini". Highlighting skipped

there

bind so this is not your fault. i'll clean up those source files and highlighting later tonight

http://pastebin.com/KuyzJUqq stevepiercy

you can continue doing your write up, and eventually you can pull in my changes to master

you can also turn off the -W flag which i think treats warnings as errors, just so you can generate output, although without some highlighting

let me see ...

env/bin/sphinx-build --help

yup, that's what it does

that works ... still some warnings but the page builds :)

line 5 in the Makefile has SPHINXOPTS = -W

yay!

so ... PR and awaiting feedback if any?

i gotta run now, but if you hit any other snags, i'll catch you on the scrollback

bind correct

yes please

stevepiercy: done #171

moo-_-: fragile? is there anything that goes wrong more often with sphinx then when projects grow large?

bind: it's same as any software project. to manage complexity you need plugins and third party packages. pindowns. updates. incompatibilities with native libraries. and so on.

bind: suddenly readthedocs cannot build your docs because python versions and native libs

and so on

moo-_-: I see :)

ever tried pandoc moo-_- ?

also a nice piece of software :) (but well ... has it's own share of incompatibilities at some places :))

yes

I will head for the bed here ... bb and hf!

moo-_- bind all software is terrible

wetware is worse, though

the safari tutorial on Pyramid is pretty good

safari/oreilly/same thing