Author Topic: Documentation building query - scrguide.gst where is it?  (Read 7888 times)

Offline AndrewCot

  • Plugin developer
  • Lives here!
  • ****
  • Posts: 679
Documentation building query - scrguide.gst where is it?
« on: August 11, 2021, 08:17:50 am »
This is probably my fault as this is the very first time I have played with LaTex and it's tools, so I am as newbie as it gets with this.

I grabbed the http://svn.code.sf.net/p/codeblocks/code/docs/ repo and am following the userguide/ReaMe.txt, but instead of downloading the 4.2GB ISO I found that there is a specific Windows release on https://miktex.org/download  that is only 128MB (https://miktex.org/download/ctan/systems/win32/miktex/setup/windows-x64/basic-miktex-21.6-x64.exe).  It looks like it has all of the relevant exe's and bits.

When I run the make -f makefiles/gendocu.mak pdf MAINFILE=main_codeblocks_en command I get the following at the end of the process:
Code
### simple group (level 1) entered at line 18 ({)
### bottom level
(see the transcript file for additional information) <C:\Users\andrew\AppData\L
ocal\MiKTeX\fonts/pk/ljfour/jknappen/ec/dpi600\tctt1200.pk>{C:/Users/andrew/App
Data/Local/Programs/MiKTeX/fonts/enc/dvips/base/8r.enc} <C:\Users\andrew\AppDat
a\Local\MiKTeX\fonts/pk/ljfour/jknappen/ec/dpi600\tcrm1095.pk> <C:\Users\andrew
\AppData\Local\MiKTeX\fonts/pk/ljfour/jknappen/ec/dpi600\ecrm1095.pk> <C:\Users
\andrew\AppData\Local\MiKTeX\fonts/pk/ljfour/jknappen/ec/dpi600\tcrm1200.pk><C:
/Users/andrew/AppData/Local/Programs/MiKTeX/fonts/type1/public/amsfonts/cm/cmbx
10.pfb><C:/Users/andrew/AppData/Local/Programs/MiKTeX/fonts/type1/public/amsfon
ts/cm/cmbx12.pfb><C:/Users/andrew/AppData/Local/Programs/MiKTeX/fonts/type1/pub
lic/amsfonts/cm/cmmi10.pfb><C:/Users/andrew/AppData/Local/Programs/MiKTeX/fonts
/type1/public/amsfonts/cm/cmmi12.pfb><C:/Users/andrew/AppData/Local/Programs/Mi
KTeX/fonts/type1/public/amsfonts/cm/cmr10.pfb><C:/Users/andrew/AppData/Local/Pr
ograms/MiKTeX/fonts/type1/public/amsfonts/cm/cmr12.pfb><C:/Users/andrew/AppData
/Local/Programs/MiKTeX/fonts/type1/public/amsfonts/cm/cmsl12.pfb><C:/Users/andr
ew/AppData/Local/Programs/MiKTeX/fonts/type1/public/amsfonts/cm/cmssbx10.pfb><C
:/Users/andrew/AppData/Local/Programs/MiKTeX/fonts/type1/public/amsfonts/cm/cms
y10.pfb><C:/Users/andrew/AppData/Local/Programs/MiKTeX/fonts/type1/public/amsfo
nts/cm/cmti12.pfb><C:/Users/andrew/AppData/Local/Programs/MiKTeX/fonts/type1/pu
blic/amsfonts/cm/cmtt10.pfb><C:/Users/andrew/AppData/Local/Programs/MiKTeX/font
s/type1/public/amsfonts/cm/cmtt12.pfb><C:/Users/andrew/AppData/Local/Programs/M
iKTeX/fonts/type1/urw/courier/ucrr8a.pfb>
Output written on main_codeblocks_en.pdf (139 pages, 2664149 bytes).
Transcript written on main_codeblocks_en.log.
if (test -e main_codeblocks_en.idx); then splitindex.pl main_codeblocks_en.idx -- -g -s mystyle.ist; fi
if (test -e main_codeblocks_en.glo); then makeindex -g -r -s scrguide.gst -o main_codeblocks_en.chn main_codeblocks_en.glo; fi
Index style file scrguide.gst not found.
Usage: makeindex [-ilqrcgLT] [-s sty] [-o ind] [-t log] [-p num] [idx0 idx1 ...]
make: *** [makefiles/gendocu.mak:459: main_codeblocks_en.pdf] Error 1

The problem is that in the gendou.mak line 199 is:
Code
MAKECHANGE = makeindex -g -r -s scrguide.gst -o

The pdf rule in the is:
Code
ifeq ($(COMPILER),$(LATEX))
$(MAINFILE).pdf: $(MAINFILE).ps
$(GS) $(GSOPT) -sOutputFile=$(MAINFILE).pdf -c save pop -f $(MAINFILE).ps
endif
ifeq ($(COMPILER),$(PDFLATEX))
$(MAINFILE).pdf: $(MAINFILE).tex
ifneq ($(MSG), default)
@echo $(MSG) && $(SHELLPAUSE)
endif
if ($(TESTDIR) $(GRAPHICS_SVG)); then make -f $(GENDOCU) svg2pdf SRC="$(shell ls $(GRAPHICS_SVG)/*.svg)"; fi
$(PDFLATEX) $(EPSTOPDFOPT) $(OPTS) $(SAMP)\input $(MAINFILE).tex$(SAMP) && \
$(PDFLATEX) $(EPSTOPDFOPT) $(OPTS) $(SAMP)\input $(MAINFILE).tex$(SAMP) && \
if ($(TESTFILE) $(MAINFILE).idx); then $(MAKEINDEX) $(MAINFILE).idx $(INDEXOPT); fi
if ($(TESTFILE) $(MAINFILE).glo); then $(MAKECHANGE) $(MAINFILE).chn $(MAINFILE).glo; fi
if ($(TESTFILE) $(MAINFILE).bib); then $(BIBTEX) $(MAINFILE); fi
$(PDFLATEX) $(EPSTOPDFOPT) $(OPTS) $(SAMP)\input $(MAINFILE).tex$(SAMP)
endif
## $(PDFLATEX) -jobname=NUP1x2_$(MAINFILE) $(SAMP)\documentclass{scrbook} \usepackage[pdftex]{graphicx} \usepackage{pdfpages} \usepackage[pdftex]{hyperref} \begin{document} \includepdf[pages=-, nup=1x2, landscape]{$(MAINFILE).pdf} \end{document}$(SAMP)
if !($(TESTDIR) $(PDFOUTPUT)); then $(MKDIRPARENT) $(PDFOUTPUT); fi
ifeq ($(PREFIX),)
$(CP) $(MAINFILE).pdf $(PDFOUTPUT)/$(MAINFILE).pdf
else
$(CP) $(MAINFILE).pdf $(PDFOUTPUT)/$(PREFIX)_$(CUSTOMER)$(MAINFILE).pdf
endif


How is the scrguide.gst produced or where do I get it from?
Looks like miktex does not work can be a valid answer IF and only IF the TeXLive ISo method works with the current files in the repo I do not want to download 4.2GB if I don't have to.

Offline gd_on

  • Lives here!
  • ****
  • Posts: 800
Re: Documentation building query - scrguide.gst where is it?
« Reply #1 on: August 11, 2021, 09:40:29 am »
Personnaly, I don't use this method to build manuals. I have never been able to make it work, probably because a few tools or files are missing on my PC.
You can find some indications at least in https://forums.codeblocks.org/index.php/topic,23614.msg160976.html#msg160976 .
« Last Edit: August 11, 2021, 11:02:00 am by gd_on »
Windows 11 64 bits (23H2), svn C::B (last version or almost!), wxWidgets 3.2.5 (tests with 3.3), Msys2 Compilers 14.1.0, 64 bits (seh, posix : gcc, g++ and gfortran in C:\msys64\mingw64) or 32 bits (dwarf2, posix  in C:\msys64\mingw32).

Offline AndrewCot

  • Plugin developer
  • Lives here!
  • ****
  • Posts: 679
Re: Documentation building query - scrguide.gst where is it?
« Reply #2 on: August 11, 2021, 10:58:14 am »
Thanks for the post. It looks good for me to give it a go in the morning as I want to watch some TV tonight.