User forums > Using Code::Blocks

user/developer document

(1/3) > >>

ollydbg:
I only see an old discussion here about the document.
Preliminary documentation
And also check out the repo: svn.berlios.de/svnroot/repos/codeblocks/docs
The question is:
Are there any official way(instructions) to build those files? (I mean I would like to build it under Windows, Miktex), I see some tex files, also some xml files.

The only issue is I don't want to do extra(duplicate) work between this Latex docs and wiki pages.
Personally I would like to use Latex tools like LYX to edit the latex files. (LYX is quite powerful)

Also, I would like to think we should synchronize the feature in the trunk and the documents. Like in GDB's repo, when some one add a new feature, they should also add the new document pieces, and new test cases.

MortenMacFly:
The LaTeX documentation is under:
http://svn.berlios.de/svnroot/repos/codeblocks/docs/userguide

There is a Makefile for Linux, but you can use free tools like TeXMaker (http://www.xm1math.net/texmaker) or TeXnicCenter (http://www.texniccenter.org) to edit. There are two main files:

* main_codeblocks_de.tex
* main_codeblocks_en.texIf you just open these an let the tool gather the document structure you should be fine. Both tools work with MiKTeX - for TeXnicCenter download the latest ALPHA version (http://sourceforge.net/projects/texniccenter/files/TeXnicCenter Alpha/2Alpha4/TXCSetup_2Alpha4_Win32.exe).

I personally prefer WinEdt (http://winedt.com/) which I am very used too and like it a lot. However, its commercial so you need to buy a license (which I did because its my #1 favourite LaTeX IDE).

Please don't use Lyx as this spoils the raw TeX documents so they become unreadable and hard to maintain. IMHO Lyx is for people that use Word all the time and are forced to use LaTeX. But if you want to do some extra-ordinary or tweaking you are horrible lost with Lyx.

...maybe Mario or I find the time to provide a TeXnicCenter project file.

BTW: Keep in mind that besides MiKTeX/LaTeX you also need GhostScript (maybe GhostView), a PDF viewer (I use "PDF-XChange Viewer Free", see http://www.tracker-software.com/pdf-xchange-products-comparison-chart) and probably the MS HTML compiler under Windows.

If you never used LaTeX there is a need for some learning curve, but in the end, LaTeX is the most beautiful type setting on earth... ;D

MortenMacFly:
...I've added a WinEdt project file to the documentation (for the English version) and made the project actually compile under Windows with default MiKTeX environment.

I think the docu needs some cleanup concerning the macros and styles used. I would prefer to use a default style w/o dependency on a lot of user-defined styles.

ollydbg:
Thanks morten. I just update to the latest revision.

I have Miktex installed already. It have a Texworks installed by default. I just open the file "main_codeblocks_en.tex" and select "pdflatex", and hit the build button, and then "main_codeblocks_en.pdf" was successfully build and shown in another Texworks window. Cheers!!! :)

BTW: I used latex when I'm in school. But I'm not a latex export ;).

EDIT: In Texworks, we should select "pdfLatex+makeIndex+bibtex", so the hyperlinks will be shown correctly in the pdf. (Otherwise, it will show many "??")

MortenMacFly:

--- Quote from: ollydbg on April 14, 2012, 03:49:52 pm ---I have Miktex installed already. It have a Texworks installed by default.

--- End quote ---
Yes, I completely forgot about that option... sure - this will work. TeXWorks has improved a lot lately. Even easier for people that want to contribute. :D

Navigation

[0] Message Index

[#] Next page