SRL Archive - The Bashing Club / BBQ Pit

Aaaaaarrrggg!!! I hate you sphinx!!!


masterBB

2011-08-17 09:22:08

STUPID PIECE OF SHIT! I hate it, I hate it, I hate it… I tried my best to install sphinx documentation toolsshit again on my windows laptop cause I can't get on ubuntu laptop next weeks. And it doesn't work! I always record my times how long I need to install things on my computer. And I've reached 8 hours already! AAAARRGG! I need to demolish something or someone cause frustration is killing me. And they say this makes documenting fun:fiery:

Ofcourse they don't have an installer with python and such automatically installed. Ofcourse they don't link you to python with a good step for step, easy to follow tutorial. And when you have installed python and you think you can install sphinx, they give me an EGG, yeah an EGG. What do I have to do with an EGG! Wikipedia didn't know it either. AAARRG! I can boil, bake, throw an egg, but something usefull. I figured out they want me to do something different. This is just like zelda btw, except you don't hear that sound when you solve it. You just get new problems.

Suddenly a wild idea appeared, my three step plan to open shitty files; Winrar else notepad or else VLC player. After opening it with winrar I got one map full of useless not working shit! I've spent hours solving the errors. Till I gave up and threw the map away. I was this |—| close to burn my complete hard drive. So I searched and searched and found out I need easy install <- the name is a troll and not winrar. I installed it. And finally I could install the .egg. Still missing the zelda melody.

But the fun isn't over yet! They really want to make this install be a memory you will never forget. At this point I already pulled so much hair out, I had to start plucking my eyebrows! Sphinx_build errors, yeee! Just what I need. Errors! So user friendly, I love them. I even want to sleep with them, if it wasn't that I'm sure that the sphinx project isn't 18 years old yet! Something this shitty can't survive that long. So many errors. I was surprised that I couldn't find any relations between microsoft and sphinx. So odd.

I'm done for today. But tomorrow I will continue my quest to install sphinx on my windows laptop. Although I'm sure the rewards aren't worth it, I already lost my motivation after 10 minutes. I have to install it cause I'm a winner, and winners never quit and winners that quit are losers.

/rant

nielsie95

2011-08-17 09:25:53

You only need Sphinx if you actually want to generate documents. For writing, you need not much more than notepad :) What are you going to use it for if I may ask?

Wizzup?

2011-08-17 09:25:57

I'm sorry to hear that, are we talking about the same sphinx?

http://sphinx.pocoo.org/

AFAIK you just have to install python; and then use easy_install to install sphinx.

E: Also, what nielsie said. It's not an issue if you provide us with documentation that has some markup errors, we can fix that too. :)

Shuttleu

2011-08-17 09:55:44

okay i managed to get it setup

my workaround was openup the make.bat
then replace %SPHINXBUILD% with C:\Python27\Scripts\sphinx-build.exe

~shut

download and install python from here: http://www.python.org/download/
if your using x64 then download :http://peak.telecommunity.com/dist/ez_setup.py
open up cmd and browse to where you saved the ez_setup.py
type in C:\Python27/python.exe ez_setup.py
the using explorer go to C:\Python27/Scripts
open and run C:\Python27\sphinx-quickstart.exe

the go to where you put the build directory and open up the make.bat
everywhere you see %SPHINXBUILD% replace it with C:\Python27\Scripts\sphinx-build.exe

masterBB

2011-08-17 09:57:45

From: nielsie95
You only need Sphinx if you actually want to generate documents. For writing, you need not much more than notepad :) What are you going to use it for if I may ask?


Writing TPA docs, I've done this before on ubuntu. Which went smooth. IT can be done in 'notepad' as far as I know. Though I'm not sure which program I used in ubuntu.

From: Wizzup?
I'm sorry to hear that, are we talking about the same sphinx?

http://sphinx.pocoo.org/

AFAIK you just have to install python; and then use easy_install to install sphinx.

E: Also, what nielsie said. It's not an issue if you provide us with documentation that has some markup errors, we can fix that too. :)


Still I like it to see it in html. It's just for me. But for some reason nothing works on windows. And I get no error while installing sphinx, I can quickstart a project. But I'm not able to build. I hate it when nothing is clear what the problem is. Anyway, tomorrow I will try again. This was just a rant.

Shuttleu

2011-08-17 10:02:30

From: masterBB
Writing TPA docs, I've done this before on ubuntu. Which went smooth. IT can be done in 'notepad' as far as I know. Though I'm not sure which program I used in ubuntu.



Still I like it to see it in html. It's just for me. But for some reason nothing works on windows. And I get no error while installing sphinx, I can quickstart a project. But I'm not able to build. I hate it when nothing is clear what the problem is. Anyway, tomorrow I will try again. This was just a rant.


look above before you go to bed!

~shut

masterBB

2011-08-17 10:08:49

From: Shuttleu
look above before you go to bed!

~shut


Already did that this morning. Don't remember what my new error was. It was some sort of extension error.

e:
Still on my ctrl+v:
jsmath_path config value must be set for the jsmath extenstion to work

Shuttleu

2011-08-17 10:51:44

From: masterBB
Already did that this morning. Don't remember what my new error was. It was some sort of extension error.

e:
Still on my ctrl+v:
jsmath_path config value must be set for the jsmath extenstion to work
how about you try from scratch and follow my steps

~shut

Wizzup?

2011-08-17 16:47:18

From: masterBB
Writing TPA docs, I've done this before on ubuntu. Which went smooth. IT can be done in 'notepad' as far as I know. Though I'm not sure which program I used in ubuntu.


Perhaps it is a good idea to rebase some of your work on Shuttleu's, he did some TPA documentation (one or two) days ago as well. It's on master, in the file tpa.rst. :)

As for editing the file, I know vim supports highlighting for it, but it might not be what you're looking for. :)

masterBB

2011-08-17 18:31:19

Tomorrow I will. Anyway I'm already pretty much cooled down. The rant did its job great. And thanks for you all trying to help me, rep for the not disabled ones! (Just Shuttleu I guess) ;).

edit:
I'm not allowed to rep shuttleu again, should spread it more.

Shuttleu

2011-08-17 19:50:08

From: masterBB
edit:
I'm not allowed to rep shuttleu again, should spread it more.

damn, it seems you love me too much :p

well good luck and let me know how you get on

also from tomorrow night i will be away for a few days, so i wont be able to help you then

~shut