Skip to content

Commit fedf78f

Browse files
committed
Update READEME with additional info about alternative approach of building from sources using TexStudio.
1 parent 299a8a5 commit fedf78f

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

README.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,3 +31,16 @@ The resulting PDF will be in the build folder.
3131
Most code files have wrapping main files that exercise both the build and also contain `assert` expressions that verify correctness of the code.
3232

3333
The `verify.sh` shell script will build all (except for a few that don't compile with GCC 11) examples, and then run each of them to validate all asserts.
34+
35+
## Alternative approach of building from sources
36+
37+
If you're building from sources inside a virtual machine and the VSCode and Docker approach doesn't work for you, [TexStudio](https://www.texstudio.org/) provides an alternative solution for Windows users. Follow the steps below:
38+
39+
- Install [Anaconda](https://www.anaconda.com/) and add `C:\Users\YourUserName\anaconda3\Scripts` to system path. Replace `YourUserName` with your actual user name.
40+
- Install [TexStudio](https://www.texstudio.org/).
41+
- Go to Texstudio menu "Options -> Configure Texstudio -> Commands -> XeLaTex", and enter the following command: `xelatex.exe -synctex=1 -interaction=nonstopmode -shell-escape -aux-directory=build -output-directory=build %.tex`. This command sets both the aux and output directories to ".\build".
42+
- Go to Texstudio menu "Options -> Configure Texstudio -> Build -> Meta Commands -> Default Compiler", and enter `txs:///xelatex`. This switches the default compiler from `pdflatex` to `xelatex`. Then, enable the checkbox "Show Advanced Options".
43+
- For Texstudio menu "Options -> Configure Texstudio -> Build -> Build Options -> PDF File", enter `build`. This tells the pdf previewer to look for the generated pdf file in the ".\build" directory.
44+
- Finally, go to "Texstudio menu Options -> Configure Texstudio -> Commands -> Makeindex", and enter the following command: `makeindex.exe build%.idx`
45+
46+
These steps will enable you to build from sources inside a virtual machine using TexStudio on Windows.

0 commit comments

Comments
 (0)