Latex Transformation
IT4KT Builder allows creating LaTeX output from a course. However, in current version there are some limitations that need to be taken in mind before generation:
- Latex transformation doesn’t support SVG images.
- Latex transformation doesn’t support media tokens conversion (YouTube, video or audio tokens).
- Solution and Result elements are not hideable (modifier * has no effect).
Usage
LaTeX conversion is implemented besides main functionality of it4kt-builder. We’ve decided to generate LaTeX output to latex-output
directory instead of output
to prevent from output overriding. To run transformation you can use following command:
it4kt-builder latex
If you use recommended course layout, you cen run the command from the pyvenv
directory:
-
Unix:
pyvenv/bin/it4kt-builder latex
-
Windows:
pyvenv\Scripts\it4kt-builder latex
If you would like to change language of conversion then you can use -l
or --language
flag with translation language abbreviation as an argument. You’re free to use multiple languages for conversion:
it4kt-builder latex -l sk
# or with multiple languages
it4kt-builder latex -l sk -l en
First language is going to be treated as default language and the output will be generated at root of latex-output
directory. Another languages will be generate to subdirectories named by language you’ve just passed.
Tip
For more info about localization check dedicated localization recipe.
To manipulate included .tex files you need to edit article.tex
in generated folder.
Output directory structure
At first sight you can see that latex-output
directory is very similar to HTML output
one. You can find article.tex
file, which behaves like an index file for LaTeX project. In this file you can see all the imports including styles/it4kt.tex
file, which includes all default styles for LaTeX transformation.
You’re free to manually edit these files, but they will be overwritten as soon as you run another round of LaTeX conversion. Custom styling will be discussed in next section of this recipe page.
Custom LaTeX styling
Users are free to append custom LaTeX file to the transformation when they need to change something in template or add custom styling for their own elements (check Customize Kpimark).
These styles, unlike the default one, are not going to be overriden during conversion proccess. On every run of conversion, the tool will take the most current version of this file and append it to a transformated course.
To append custom styles file during conversion you can use -s
or --style
flag followed by path argument:
it4kt-builder latex -l sk -s my_styles.tex
Tip
The path is relative to your current terminal location.