gpsguy
Active Member
- Joined
- Jan 22, 2012
- Messages
- 4,472
Yesterday evening, I recreated a FreeBSD 10.1 VM, this time running everything as root, though I don't know if that made any difference. I installed all the same packages as I'd done on the weekend.
Since Dru mentioned the possibility of excluding the quickstart line - I decided to try that this time. Doing so, didn't have an adverse effect on the output.
After I ran the sphinx-build command, I looked at the output. Much better last night and it included the _images directory.
I ran the gmake latex command 4 times, before I realized I was looking in the wrong directory for the PDF. I *thought* it was in the _build directory. I got hung up on the "failure" error messages, documented in post #10 above. It wasn't until I'd run it a 4th time, that I saw noticed a PDF had been created. As I write this up (this morning), I noticed Dru's document does say that the PDF can be found in: _build/latex/FreeNAS.pdf
Here are the commands I ran:
After I created the HTML file, I created a .tar.gz of the _build directory and uploaded it to a FTP server, for easier retrieval.
Since Dru mentioned the possibility of excluding the quickstart line - I decided to try that this time. Doing so, didn't have an adverse effect on the output.
After I ran the sphinx-build command, I looked at the output. Much better last night and it included the _images directory.
I ran the gmake latex command 4 times, before I realized I was looking in the wrong directory for the PDF. I *thought* it was in the _build directory. I got hung up on the "failure" error messages, documented in post #10 above. It wasn't until I'd run it a 4th time, that I saw noticed a PDF had been created. As I write this up (this morning), I noticed Dru's document does say that the PDF can be found in: _build/latex/FreeNAS.pdf
Here are the commands I ran:
Code:
pkg install devel/git pkg install textproc/py-sphinx pkg install print/tex-formats pkg install print/tex-dvipsk pkg install devel/gmake pkg install textproc/py-sphinxcontrib-httpdomain mkdir FreeNAS_9.3 cd FreeNAS_9.3 git clone git://github.com/freenas/freenas.git cd /root/FreeNAS_9.3/freenas/docs/userguide sphinx-build -b html . _build yes '' | gmake latexpdf
After I created the HTML file, I created a .tar.gz of the _build directory and uploaded it to a FTP server, for easier retrieval.