@jutge.org/toolkit 4.2.7 → 4.2.9

package/assets/latex/root-pdf.tpl.tex

@@ -0,0 +1,29 @@
+\documentclass[11pt]{article}
+
+\usepackage{jutge}
+\usepackage{{curly jutgeLanguage}}
+
+\begin{document}
+
+\providecommand{\SampleOneCol}{{curly samples1c}} 
+\providecommand{\SampleTwoCol}{{curly samples2c}} 
+
+\ProblemId{{curly id}}
+
+\DoProblem{{curly language}} 
+
+\ProblemInformation
+
+\Author: {{author}}
+
+{{#if translator}}
+    {{language}}: {{translator}}
+{{/if}}
+
+\Generation: {{date}}
+
+\subsection*{Draft}
+
+Draft generated with \textbf{new-jutge-toolkit}.
+
+\end{document}

package/assets/latex/root-text.tpl.tex

@@ -0,0 +1,34 @@
+    
+\documentclass[11pt]{article}
+
+\usepackage{jutge}
+\usepackage{{curly jutgeLanguage}}
+
+% redefine commands to simplify text output
+\renewcommand{\Sample}{}
+\renewcommand{\Statement}{}
+\renewcommand{\Problem}[1]{\section{#1}}
+\ProblemId{{curly id}}
+
+% redefine figure commands to avoid troubles with \parpic
+\renewcommand{\FigureL}[2]{\includegraphics[#1]{#2}}
+\renewcommand{\FigureC}[2]{\includegraphics[#1]{#2}}
+\renewcommand{\FigureR}[2]{\includegraphics[#1]{#2}}
+
+\begin{document}
+
+\DoProblem{{curly language}} 
+
+
+\subsection*{\TxtAuthor}
+{{author}}
+
+{{#if translator}}
+    {{language}}: {{translator}}
+{{/if}}
+
+\subsection*{Draft}
+
+Draft generated with \textbf{new-jutge-toolkit}.
+
+\end{document}

package/assets/problems/demo/demo.pbm/README.md

@@ -0,0 +1,24 @@
+# Demo Problem
+
+## Features
+
+- Text formatting
+- Special characters
+- Mathematical expressions
+- Conditional rendering
+- Images
+- Code snippets
+- Inline code
+- Colors
+- PS Tricks
+- Tikz
+- Chessboards
+- Sectioning macros
+- Programming language configurations
+- Interface descriptions
+- Scoring descriptions
+- Sample input/output macros
+
+## Abstract
+
+This document is a comprehensive guide to creating problem statements for Jutge.org using LaTeX, covering text formatting, mathematical expressions, code snippets, images, and various specialized features that render across multiple output formats (PDF, HTML, Markdown, and plain text).

package/assets/problems/demo/demo.pbm/award.html

@@ -0,0 +1 @@
+<p>Problem solved, congratulations!</p>

package/assets/problems/demo/demo.pbm/handler.yml

@@ -0,0 +1,2 @@
+handler: std
+solution: Python3

package/assets/problems/demo/demo.pbm/jutge.svg

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg  viewBox="0 0 49 66" version="1.1" xmlns="http://www.w3.org/2000/svg">
+<path fill="#ffffff" d=" M 0.00 0.00 L 49.00 0.00 L 49.00 66.00 L 0.00 66.00 L 0.00 0.00 Z" />
+<path fill="#464847" d=" M 5.72 8.49 C 6.65 5.88 9.84 6.49 12.00 6.32 C 21.01 6.50 30.02 6.34 39.03 6.32 C 40.76 6.13 42.43 6.94 43.21 8.52 C 43.99 11.55 43.27 14.84 44.11 17.80 C 45.49 18.74 47.21 19.77 47.28 21.66 C 47.57 23.41 46.00 24.67 45.21 26.06 C 47.18 27.64 47.91 30.03 46.63 32.31 C 46.71 31.15 46.79 29.98 46.88 28.82 C 46.14 27.92 45.41 27.03 44.68 26.13 C 44.04 26.10 42.76 26.05 42.12 26.03 C 41.49 27.57 40.06 29.17 40.86 30.92 C 41.39 33.00 43.85 33.12 45.45 33.98 C 44.55 33.82 42.74 33.51 41.84 33.35 C 40.04 31.03 40.09 28.17 41.84 25.81 C 40.26 23.77 40.33 21.30 40.77 18.88 C 37.72 17.01 34.77 14.89 32.72 11.90 C 34.54 13.79 36.46 15.59 38.56 17.17 C 39.93 17.96 41.47 19.42 42.88 17.84 C 44.24 15.47 43.16 12.61 43.11 10.05 C 43.20 7.96 41.25 6.85 39.46 6.48 C 32.48 6.54 25.50 6.63 18.53 6.68 C 16.37 6.61 14.21 6.55 12.05 6.54 C 10.13 6.74 7.87 6.51 6.32 7.86 C 5.39 11.06 5.70 14.45 5.52 17.74 C 6.58 18.46 7.64 19.17 8.70 19.89 C 11.13 19.27 13.57 18.66 15.98 17.96 C 19.12 16.97 22.25 15.98 25.32 14.78 C 27.32 13.94 29.27 12.98 31.18 11.95 C 24.53 16.43 16.45 17.90 8.88 20.13 C 8.62 22.91 8.08 25.75 5.00 26.90 C 9.37 25.00 8.70 30.27 7.98 32.56 C 5.46 33.78 1.28 34.45 2.18 38.30 C 2.42 38.75 2.90 39.67 3.13 40.12 C 0.60 38.45 1.82 35.18 3.71 33.63 C 0.39 30.62 4.11 26.38 1.94 23.02 C 0.97 20.66 3.26 18.57 5.20 17.67 C 5.41 14.61 5.20 11.52 5.72 8.49 Z" />
+<path fill="#d5d5d5" d=" M 6.32 7.86 C 7.87 6.51 10.13 6.74 12.05 6.54 C 12.54 7.29 13.02 8.04 13.51 8.79 C 13.09 10.26 12.68 11.74 12.26 13.22 C 12.90 13.46 13.54 13.69 14.18 13.93 C 13.28 15.78 14.45 16.99 15.98 17.96 C 13.57 18.66 11.13 19.27 8.70 19.89 C 7.64 19.17 6.58 18.46 5.52 17.74 C 5.70 14.45 5.39 11.06 6.32 7.86 Z" />
+<path fill="#e4e4e4" d=" M 12.05 6.54 C 14.21 6.55 16.37 6.61 18.53 6.68 C 20.09 7.21 21.63 7.79 23.17 8.36 C 22.89 9.77 22.61 11.18 22.33 12.59 C 23.32 13.32 24.32 14.05 25.32 14.78 C 22.25 15.98 19.12 16.97 15.98 17.96 C 14.45 16.99 13.28 15.78 14.18 13.93 C 13.54 13.69 12.90 13.46 12.26 13.22 C 12.68 11.74 13.09 10.26 13.51 8.79 C 13.02 8.04 12.54 7.29 12.05 6.54 Z" />
+<path fill="#efefef" d=" M 18.53 6.68 C 25.50 6.63 32.48 6.54 39.46 6.48 C 39.93 10.07 39.67 13.70 38.56 17.17 C 36.46 15.59 34.54 13.79 32.72 11.90 C 32.59 11.75 32.34 11.45 32.22 11.31 C 31.96 11.47 31.44 11.79 31.18 11.95 C 29.27 12.98 27.32 13.94 25.32 14.78 C 24.32 14.05 23.32 13.32 22.33 12.59 C 22.61 11.18 22.89 9.77 23.17 8.36 C 21.63 7.79 20.09 7.21 18.53 6.68 Z" />
+<path fill="#dcdcdc" d=" M 39.46 6.48 C 41.25 6.85 43.20 7.96 43.11 10.05 C 43.16 12.61 44.24 15.47 42.88 17.84 C 41.47 19.42 39.93 17.96 38.56 17.17 C 39.67 13.70 39.93 10.07 39.46 6.48 Z" />
+<path fill="#eddccb" d=" M 31.18 11.95 C 31.44 11.79 31.96 11.47 32.22 11.31 C 32.34 11.45 32.59 11.75 32.72 11.90 C 34.77 14.89 37.72 17.01 40.77 18.88 C 40.33 21.30 40.26 23.77 41.84 25.81 C 40.09 28.17 40.04 31.03 41.84 33.35 C 41.41 33.73 40.56 34.50 40.13 34.88 C 39.32 37.93 41.17 40.39 43.38 42.23 C 43.19 44.60 42.88 47.27 40.80 48.81 C 34.15 49.95 27.38 48.20 20.72 49.27 C 16.63 49.71 12.51 49.40 8.41 49.50 C 6.00 47.26 4.74 44.15 5.12 40.82 C 6.22 40.66 7.32 40.50 8.41 40.28 C 8.40 38.61 8.51 36.93 8.45 35.26 C 8.33 34.59 8.09 33.23 7.98 32.56 C 8.70 30.27 9.37 25.00 5.00 26.90 C 8.08 25.75 8.62 22.91 8.88 20.13 C 16.45 17.90 24.53 16.43 31.18 11.95 Z" />
+<path fill="#d7d7d7" d=" M 2.22 23.09 C 1.70 20.80 3.49 19.19 5.02 17.85 C 6.16 18.58 7.31 19.29 8.46 20.01 C 8.15 21.93 8.48 25.04 5.98 25.54 C 4.18 26.33 3.46 23.87 2.22 23.09 Z" />
+<path fill="#d3d4d6" d=" M 45.25 25.74 C 40.12 27.53 38.76 18.01 44.07 18.46 C 47.42 19.29 47.41 23.62 45.25 25.74 Z" />
+<path fill="#010402" d=" M 17.98 33.17 C 15.74 29.78 14.92 23.82 18.91 21.44 C 21.17 24.83 21.95 30.76 17.98 33.17 Z" />
+<path fill="#010203" d=" M 29.14 21.46 C 32.98 23.76 32.90 30.75 29.24 33.21 C 26.65 29.84 26.67 24.89 29.14 21.46 Z" />
+<path fill="#d9d9d8" d=" M 42.12 26.03 C 42.76 26.05 44.04 26.10 44.68 26.13 C 45.41 27.03 46.14 27.92 46.88 28.82 C 46.79 29.98 46.71 31.15 46.63 32.31 C 46.58 33.00 46.56 33.69 46.51 34.38 C 46.13 36.60 47.07 40.17 44.00 40.64 C 40.91 40.56 40.88 37.08 40.13 34.88 C 40.56 34.50 41.41 33.73 41.84 33.35 C 42.74 33.51 44.55 33.82 45.45 33.98 C 43.85 33.12 41.39 33.00 40.86 30.92 C 40.06 29.17 41.49 27.57 42.12 26.03 Z" />
+<path fill="#dbdbdb" d=" M 2.80 28.85 C 3.51 26.64 6.12 27.70 7.75 26.96 C 8.55 29.07 8.65 32.43 5.96 33.15 C 3.43 34.66 1.97 30.77 2.80 28.85 Z" />
+<path fill="#d2d7da" d=" M 2.18 38.30 C 1.28 34.45 5.46 33.78 7.98 32.56 C 8.09 33.23 8.33 34.59 8.45 35.26 C 8.27 36.63 8.19 38.01 8.07 39.39 C 6.69 39.84 5.29 40.32 3.82 40.21 L 3.13 40.12 C 2.90 39.67 2.42 38.75 2.18 38.30 Z" />
+<path fill="#010100" d=" M 8.07 39.39 C 8.19 38.01 8.27 36.63 8.45 35.26 C 8.51 36.93 8.40 38.61 8.41 40.28 C 7.32 40.50 6.22 40.66 5.12 40.82 C 4.74 44.15 6.00 47.26 8.41 49.50 C 12.51 49.40 16.63 49.71 20.72 49.27 L 20.54 50.18 C 20.62 51.20 20.78 53.23 20.86 54.25 C 20.73 54.37 20.47 54.60 20.33 54.71 C 20.23 53.25 20.10 51.79 19.94 50.34 L 19.86 49.75 C 17.08 49.84 14.34 50.37 11.67 51.13 C 10.64 55.18 10.12 60.32 13.94 63.11 C 10.65 63.03 7.36 63.03 4.07 63.23 C 4.50 59.08 5.38 54.97 5.25 50.78 C 6.59 47.65 4.40 44.24 4.75 40.92 C 4.35 40.72 3.54 40.32 3.13 40.12 L 3.82 40.21 C 5.29 40.32 6.69 39.84 8.07 39.39 Z" />
+<path fill="#ada093" d=" M 40.13 34.88 C 40.88 37.08 40.91 40.56 44.00 40.64 C 47.07 40.17 46.13 36.60 46.51 34.38 C 48.63 37.10 47.01 40.23 44.25 41.58 C 44.13 44.42 43.59 47.22 42.21 49.73 C 39.66 49.59 37.11 49.56 34.57 49.57 C 32.54 49.55 30.51 49.67 28.49 49.78 L 27.71 49.81 C 25.32 49.95 22.93 50.08 20.54 50.18 L 20.72 49.27 C 27.38 48.20 34.15 49.95 40.80 48.81 C 42.88 47.27 43.19 44.60 43.38 42.23 C 41.17 40.39 39.32 37.93 40.13 34.88 Z" />
+<path fill="#010100" d=" M 14.82 39.58 C 20.72 42.70 27.94 42.40 34.04 39.98 C 29.44 45.66 19.14 45.53 14.82 39.58 Z" />
+<path fill="#fcfbfa" d=" M 8.31 46.79 C 14.53 46.25 20.78 46.66 27.02 46.57 C 31.59 46.66 36.21 46.11 40.73 46.98 C 38.81 48.56 36.23 48.11 33.93 48.17 C 26.97 48.01 20.01 48.13 13.05 48.15 C 11.49 47.85 9.06 48.72 8.31 46.79 Z" />
+<path fill="#242424" d=" M 11.67 51.13 C 14.34 50.37 17.08 49.84 19.86 49.75 L 19.94 50.34 C 18.51 50.73 16.95 50.86 15.66 51.64 C 15.11 55.44 14.34 60.00 17.09 63.17 C 16.31 63.15 14.73 63.13 13.94 63.11 C 10.12 60.32 10.64 55.18 11.67 51.13 Z" />
+<path fill="#fefefe" d=" M 20.54 50.18 C 22.93 50.08 25.32 49.95 27.71 49.81 C 27.92 54.50 29.55 58.90 31.07 63.28 C 26.70 63.47 22.33 63.45 17.96 63.25 C 18.77 60.41 19.69 57.60 20.33 54.71 C 20.47 54.60 20.73 54.37 20.86 54.25 C 20.78 53.23 20.62 51.20 20.54 50.18 Z" />
+<path fill="#464847" d=" M 27.71 49.81 L 28.49 49.78 C 30.20 50.31 31.87 50.92 33.55 51.52 C 34.86 55.45 34.59 59.62 32.25 63.10 C 32.87 63.08 34.10 63.03 34.72 63.00 C 38.13 62.98 41.53 62.99 44.94 63.19 C 31.34 63.76 17.68 63.61 4.07 63.23 C 7.36 63.03 10.65 63.03 13.94 63.11 C 14.73 63.13 16.31 63.15 17.09 63.17 C 14.34 60.00 15.11 55.44 15.66 51.64 C 16.95 50.86 18.51 50.73 19.94 50.34 C 20.10 51.79 20.23 53.25 20.33 54.71 C 19.69 57.60 18.77 60.41 17.96 63.25 C 22.33 63.45 26.70 63.47 31.07 63.28 C 29.55 58.90 27.92 54.50 27.71 49.81 Z" />
+<path fill="#212121" d=" M 28.49 49.78 C 30.51 49.67 32.54 49.55 34.57 49.57 C 35.77 50.19 36.95 50.85 38.14 51.51 C 37.76 54.84 37.55 58.19 37.49 61.54 C 36.57 62.04 35.65 62.53 34.72 63.00 C 34.10 63.03 32.87 63.08 32.25 63.10 C 34.59 59.62 34.86 55.45 33.55 51.52 C 31.87 50.92 30.20 50.31 28.49 49.78 Z" />
+<path fill="#010202" d=" M 34.57 49.57 C 37.11 49.56 39.66 49.59 42.21 49.73 L 43.50 49.80 C 43.39 54.31 44.30 58.75 44.94 63.19 C 41.53 62.99 38.13 62.98 34.72 63.00 C 35.65 62.53 36.57 62.04 37.49 61.54 C 37.55 58.19 37.76 54.84 38.14 51.51 C 36.95 50.85 35.77 50.19 34.57 49.57 Z" />
+</svg>

package/assets/problems/demo/demo.pbm/problem.en.tex

@@ -0,0 +1,301 @@
+\Problem{Demo Problem}
+
+\Statement
+
+\paragraph{Abstract.}
+
+This a demo problem whose statement includes many elements that can be used in Jutge.org. 
+Please refer to its source code to see how to include these elements in your own problem statements.
+
+\medskip
+
+Problems statements are written in \LaTeX, which allows for great flexibility and high-quality typesetting.
+Resulting statements are rendered in PDF, HTML, Markdown, and plain Text formats. Jutge.org aims to have
+a consistent appearance across all formats, although some features may vary depending on the capabilities of each format.
+
+
+\paragraph{Text.}
+
+Regular text is just written as \LaTeX. 
+It is important to remember to separate paragraphs with the \verb|\medskip| macro.
+
+\medskip
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus lacinia odio vitae vestibulum vestibulum. 
+Cras venenatis euismod malesuada. 
+Nullam ac erat ante. 
+Sed vel lacus id mauris dapibus facilisis. 
+Nam euismod, tortor nec pharetra ultricies, ante erat imperdiet velit, nec laoreet enim lacus a velit.
+
+\medskip
+
+Latin accents and special characters are supported out of the box: Bé, sí, allà algú dirà: «Què farà l'avió demà?» "Potser" vindrà ràpid, però demanarà atenció. 
+Greek letters works well: Καλημέρα, πώς είστε σήμερα.
+Asiatic languages work well in HTML but not in PDF: 你好，很高兴认识你。「はじめまして、よろしくお願いします。」.
+Emojis work well in HTML but not so-so in PDF: ⚠ 😀 .
+
+\paragraph{Maths.}
+
+The use of mathematical expressions is also supported. 
+They can be included inline, like the famous $E = mc^2$ formula or simply as $\sqrt x$, or as separate displayed equations. 
+For example, we can write the quadratic formula as follows:
+
+\[
+    x = \frac{{-b \pm \sqrt{{b^2 - 4ac}}}}{{2a}}
+\]
+
+or express the Pythagorean theorem:
+
+\[
+    a^2 + b^2 = c^2
+\] 
+
+The rendering of these expressions will use MathML in the HTML version, ensuring very nice results. 
+In the Text and Markdown versions, mathematical expressions will be represented using some unicode symbols or in LaTeX format. 
+
+
+\paragraph{Conditional rendering.}
+
+Some parts of the statement can be conditionally included depending on the output format.
+
+\medskip
+
+\begin{latexonly}
+    This text is only included in the PDF version of the statement.
+\end{latexonly}
+
+\begin{htmlonly}
+    This text is only included in the HTML, Markdown and Text versions of the statement.
+\end{htmlonly}
+
+
+
+\paragraph{Images.}
+
+Images can also be included in the statement. For instance, here are two images of the famous bell tower of La Torrassa:
+
+\begin{center}
+\includegraphics[width=3cm]{campanar}
+\qquad
+\includegraphics[width=5cm]{campanar}
+\end{center}
+
+Available formats are PNG, JPG, PDF, BMP and EPS. SVG is also supported in HTML but not in PDF. Prefer vector formats (PDF, EPS, SVG) whenever possible to ensure the best quality at any size, and use PNG or JPG only for raster and photographic images.
+
+\medskip
+
+Use conditional rendering to include different images depending on the output format:
+
+\begin{center}
+\begin{latexonly}
+    \includegraphics[width=3cm]{jutge.png}
+\end{latexonly}
+\begin{htmlonly}
+    \includegraphics[width=3cm]{jutge.svg}
+\end{htmlonly}
+\end{center}
+
+In the HTML version, figures will be embedded in the document, ensuring compatibility across different browsers without relying on external files. In the Text and Markdown versions of the statement, images will be represented by their filenames enclosed in square brackets. Unfortunately, Pandoc does not honor alignment of images.
+
+
+\paragraph{Code.}
+
+Code snippets can be included using the \textbf{listings} package. Here is a simple Python code example:
+
+\begin{lstlisting}[language=Python, xleftmargin=0.75cm]
+import yogi 
+
+a = yogi.read(int)
+b = yogi.read(int)
+print(a + b)
+\end{lstlisting}
+
+and here is a C++ code example:
+
+\begin{lstlisting}[language=C++, xleftmargin=0.75cm]
+#include <iostream>
+using namespace std;
+
+int main() {
+    int a, b;
+    cin >> a >> b;
+    cout << a + b << endl;
+    return 0;
+}
+\end{lstlisting}
+
+The listings package supports many programming languages and produces nicely formatted code both in PDF and HTML statements.
+
+\medskip
+
+\lstset{language=C++}
+Code snippets can also be included inline: \lstinline|if (found) cout << pos;|.
+In this case, it was necessary to use \verb|\lstset{language=C++}| to set the language.
+
+
+\paragraph{Inline code deprecations.}
+
+The former use of at signs (@) and vertical bars (|) to include inline code snippets is deprecated because \textbf{pandoc} does not support it and introduced conflicts with other packages. You will have to replace them with \verb|\lstinline| or with \verb|\verb|| as shown above. Statements with at signs for inline listings can be automatically converted using \texttt{jtk convert transform-at-signs}.
+
+
+\paragraph{Hyperlinks.}
+
+Hyperlinks can be included in the statement using the \textbf{hyperref} package. 
+For example, visit \href{https://jutge.org}{Jutge.org} for more information.
+In the PDF and HTML versions, the link will be clickable, in the Markdown version, the URL will be displayed as required, but the Text version will only show the link text (Why? Can we fix it?).
+
+\medskip
+In addition, the \verb|Link| macro is provided to include links to other Jutge.org problems: 
+See the Hello World problem \Link{P68688}. Adding the language suffix is not recommended.
+
+
+\paragraph{Colors.}
+
+Colors can be used in the statement using the \textbf{color} package. 
+For instance, \textcolor{red}{this text is red}, \textcolor{blue}{this text is blue}, and \textcolor{green}{this text is green}.
+Of course, colors are not supported in the Text and Markdown versions of the statement.
+
+
+\paragraph{Columns.}
+
+The statement can also include multiple columns using the \textbf{multicol} package.
+Here is an example with two columns:
+
+\begin{multicols}{2}
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum
+
+\end{multicols} 
+
+This is shown in the PDF version only, as multiple columns are not supported in HTML, Text, or Markdown.
+
+
+\paragraph{PS Tricks.}
+
+PS Tricks figures can also be included in the statement but this is discouraged as it is not supported in HTML. Here is a simple example:
+
+\begin{center}
+\begin{pspicture}(0,0)(2,2)
+\psline{->}(0,0)(2,2)
+\pscircle(1,1){1}
+\end{pspicture}
+\end{center}
+
+\paragraph{Tikz.}
+
+Tikz figures can also be included in the statement but this is discouraged as it is not supported in HTML. Here is a simple example:
+
+\begin{center}
+\begin{tikzpicture}
+\draw[->] (0,0) -- (2,2);
+\draw (1,1) circle (1cm);
+\end{tikzpicture}
+\end{center}
+
+\paragraph{Chessboards.}
+
+Chessboards can also be drawn in the statement using the \texttt{chessboard} package but this is discouraged as they are not supported in HTML.
+
+\begin{center}
+    \chessboard[setpieces={Ke1, Qd1, Ra1, Rh1, Bc1, Bf1, Nb1, Ng1,
+    ke8, qd8, ra8, rh8, bc8, bf8, nb8, ng8},
+    showmover=false]
+\end{center}    
+
+
+
+\Input
+
+The Input section describes the format of the input data that your program will receive.
+
+\Output
+
+The Output section describes the format of the output data that your program must produce.
+
+\Observation
+
+There are a bunch of sectioning macros that can be used to include additional information in the statement:
+
+\begin{itemize*}
+    \item \verb|\Observation|
+    \item \verb|\Observations|
+    \item \verb|\Example|
+    \item \verb|\Precondition|
+    \item \verb|\Scoring|
+    \item \verb|\Scores|
+    \item \verb|\Hint|
+    \item \verb|\Interface|
+    \item \verb|\ObservationElastic|
+    \item \verb|\ObservationElasticII|
+    \item \verb|\ObservationNoMain|
+    \item \verb|\Solution|
+\end{itemize*}
+
+These are localized automatically depending on the language of the problem.
+
+\medskip
+
+The following macros configure the listings package used to display code snippets according to the some programming languages:
+
+\begin{itemize*}
+    \item \verb|\UseCPP|
+    \item \verb|\UsePython|
+    \item \verb|\UseHaskell|
+    \item \verb|\UseClojure|
+\end{itemize*}
+
+
+\medskip
+
+Interface macros are provided to describe possible interfaces that depend on the programming language used (we plan to improve this in the future):
+
+\Interface
+\begin{tabular}{rl}
+C++ &
+\begin{lstlisting}[language=C++]
+    int factorial(int n);
+\end{lstlisting}
+\\
+C &
+\begin{lstlisting}[language=C]
+    int factorial(int n);
+\end{lstlisting}
+\\
+Java &
+\begin{lstlisting}[language=Java]
+    public static int factorial(int n);
+\end{lstlisting}
+\\
+Python &
+\begin{lstlisting}[language=Python]
+    factorial(n)  # returns int
+\end{lstlisting}
+\\
+&
+\begin{lstlisting}[language=Python]
+    factorial(n: int) -> int
+\end{lstlisting}
+\end{tabular}
+
+\bigskip
+
+Scoring macros are provided to describe how the problem will be scored (you also need to provide a matching \texttt{scores.yml} file!):
+
+\Scoring
+
+\Score{Case A}{20}{Easy inputs.}
+\Score{Case B}{30}{Medium inputs.}
+\Score{Case C}{50}{Hard inputs.}
+
+
+\medskip
+
+Macros for including sample inputs and outputs are also provided:
+
+\begin{itemize*}
+    \item \verb|\Sample|
+    \item \verb|\SampleOneCol|
+    \item \verb|\SampleTwoCol|
+    \item \verb|\SampleSession|
+\end{itemize*}
+

package/assets/problems/demo/demo.pbm/problem.en.yml

@@ -0,0 +1,3 @@
+author: Jordi Petit
+email: jpetit@somewhere.com
+title: Demo Problem

package/assets/problems/demo/demo.pbm/sample-1.inp

@@ -0,0 +1 @@
+2 3

package/assets/problems/demo/demo.pbm/sample-2.inp

@@ -0,0 +1 @@
+15 27

package/assets/problems/demo/demo.pbm/solution.py

@@ -0,0 +1,5 @@
+import yogi
+
+a = yogi.read(int)
+b = yogi.read(int)
+print(a + b)

package/assets/sty/{judgeit.sty → jutge.sty}

@@ -1,48 +1,53 @@
-% \usepackage{html}
-
-% added for xelatex
-\usepackage{fontspec}
-\setmainfont{texgyrepagella-regular.otf}[
-    BoldFont=texgyrepagella-bold.otf,
-    ItalicFont=texgyrepagella-italic.otf,
-    BoldItalicFont=texgyrepagella-bolditalic.otf
-]
-\setsansfont{texgyreheros-regular.otf}[
-    BoldFont=texgyreheros-bold.otf,
-    ItalicFont=texgyreheros-italic.otf,
-    BoldItalicFont=texgyreheros-bolditalic.otf
-]
-\setmonofont{texgyrecursor-regular.otf}[
-    BoldFont=texgyrecursor-bold.otf,
-    ItalicFont=texgyrecursor-italic.otf,
-    BoldItalicFont=texgyrecursor-bolditalic.otf
-]
-
 %remove for xelatex
 %\usepackage{mathpazo}
 %\usepackage{helvet}
 %\usepackage{courier}
 
+\usepackage{hyperref}
+\usepackage{graphicx}
+\usepackage{moreverb} % for verbatimtabinput
 \usepackage{mdwlist}
-\usepackage{shortvrb}
 \usepackage{picins}
 \usepackage{pstricks}
 \usepackage{pst-tree}
 \usepackage{graphicx}
 \usepackage{amsmath}
 \usepackage{geometry}
-\usepackage{moreverb}
 \usepackage{multicol}
 %\usepackage[utf8]{inputenc} %remove for xelatex
 \usepackage{listings}
 \usepackage{textcomp}
 \usepackage{chessboard}
 \usepackage{tikz}
-\usepackage{wasysym}
-\usepackage{eurosym}
+%\usepackage{wasysym} % remove because not used
 \usepackage{color}
 
 
+% added for xelatex
+\usepackage{fontspec}
+\setmainfont{texgyrepagella-regular.otf}[
+    BoldFont=texgyrepagella-bold.otf,
+    ItalicFont=texgyrepagella-italic.otf,
+    BoldItalicFont=texgyrepagella-bolditalic.otf
+]
+\setsansfont{texgyreheros-regular.otf}[
+    BoldFont=texgyreheros-bold.otf,
+    ItalicFont=texgyreheros-italic.otf,
+    BoldItalicFont=texgyreheros-bolditalic.otf
+]
+\setmonofont{texgyrecursor-regular.otf}[
+    BoldFont=texgyrecursor-bold.otf,
+    ItalicFont=texgyrecursor-italic.otf,
+    BoldItalicFont=texgyrecursor-bolditalic.otf
+]
+\usepackage{unicode-math}
+\setmainfont{texgyrepagella-regular.otf}[
+    BoldFont=texgyrepagella-bold.otf,
+    ItalicFont=texgyrepagella-italic.otf,
+    BoldItalicFont=texgyrepagella-bolditalic.otf
+]
+\setmathfont{texgyrepagella-math.otf}
+
 
 \geometry{
     a4paper,twoside,
@@ -54,10 +59,6 @@
 \setlength{\parindent}{0cm}
 \pagestyle{empty}
 
-\MakeShortVerb\|
-
-\newenvironment{NoShortVerb}{\DeleteShortVerb\|}{\MakeShortVerb\|}
-
 
 \newcommand{\mysection}[1]{\subsection*{#1}}
 
@@ -273,9 +274,7 @@
 \newcommand{\uq}[1]{\texttt{\small #1}}
 
 
-\providecommand{\Link}[1]{
-    \texttt{#1} % TODO: hyperlink
-}
+\providecommand{\Link}[1]{\href{https://jutge.org/problems/#1}{\textbf{#1}}}
 
 
 
@@ -284,9 +283,7 @@
 
 \lstset{language=C++}
 \lstset{columns=flexible}
-%\lstset{basewidth={1em,1em}}
 \lstset{keepspaces=true}
-\lstset{morekeywords={string,include,cin,cout,endl}}
 \lstset{stringstyle=\ttfamily}
 \lstset{commentstyle={}}
 \lstset{numberstyle=\tiny\sffamily}
@@ -296,14 +293,12 @@
 \lstset{showstringspaces=false}
 \lstset{upquote=true}
 \lstset{texcl=true}
-\lstset{literate={->}{$\rightarrow$}1 {<=}{$\le$}1 {>=}{$\ge$}1 {!=}{$\neq$}1 {<<}{$<\!\!\!<$}2 {>>}{$>\!\!\!>$}2}
-\lstset{xleftmargin=0.25cm}
-
-%\lstMakeShortInline@       Aquesta comanda el principal, perquè aquí hem potinejat les @,
-
 
 \renewcommand{\footnote}[1]{ (#1)}
 
+% for backward compatibility but deprecated
+\providecommand{\CPP}{C++}
+
 \newcommand{\UseHaskell}{
     \lstset{language=Haskell}
     \lstset{columns=fullflexible}
@@ -318,5 +313,12 @@
 \newcommand{\UsePython}{
     \lstset{language=Python}
     \lstset{columns=fullflexible}
+    \lstset{literate={<=}{$\le$}1 {>=}{$\ge$}1 {/=}{$\neq$}1 {->}{$\rightarrow$}1 {=>}{$\Rightarrow$}1}
+}
+
+\newcommand{\UseCPP}{
+    \lstset{language=CPP}
+    \lstset{columns=fullflexible}
+    \lstset{literate={<=}{$\le$}1 {>=}{$\ge$}1 {/=}{$\neq$}1 {->}{$\rightarrow$}1 {=>}{$\Rightarrow$}1}
 }