@jutge.org/toolkit 4.2.6 → 4.2.8

package/README.md

@@ -1,5 +1,135 @@
-# new-jutge-toolkit
+# Jutge Toolkit
 
-This repository contains a toolkit for creating and managing programming exercises on the Jutge.org platform.
+A powerful command-line toolkit for creating and managing programming problems on the [Jutge.org](https://jutge.org) platform.
 
-This new repository is intended to replace the previous `jutge-toolkit` repository, providing enhanced features and improved usability for educators and developers.
+## Key Features
+
+- 📝 Create new problems from scratch or using templates
+- 🤖 Generate problems using JutgeAI
+- 🔧 Compile and test solutions in multiple programming languages
+- 📄 Generate PDF statements and other formats automatically
+- ✅ Verify solutions against test cases
+- ☁️ Upload and update problems directly to Jutge.org
+- ✨ Beautiful terminal interface with color output and help
+
+## Installation
+
+The toolkit requires [Bun](https://bun.sh) as a JavaScript runtime. Follow the installation guides for your platform:
+
+- **[Linux Installation Guide](docs/linux-installation.md)** 
+- **[macOS Installation Guide](docs/macos-installation.md)** 
+- **[Windows Installation Guide](docs/windows-installation.md)** 
+
+### Quick Install
+
+If you already have Bun installed:
+
+```bash
+bun install --global @jutge.org/toolkit
+```
+
+Verify the installation:
+
+```bash
+jtk --version
+```
+
+## Getting Started
+
+### Quick Start
+
+```bash
+# Get help
+jtk 
+jtk --help
+
+# Check system dependencies
+jtk doctor
+
+# Ask JutgeAI for help (requires API key setup)
+jtk ask "How do I create a problem?"
+
+# Clone a template problem interactively
+jtk clone
+
+# Generate a new problem with AI
+jtk generate problem
+
+# Build problem files
+cd my-problem.pbm
+jtk make
+
+# Verify a solution
+jtk verify solution.py
+
+# Upload to Jutge.org
+jtk upload
+```
+
+For a complete walkthrough, see the [Getting Started Guide](docs/getting-started-guide.md).
+
+## Documentation
+
+### Essential Guides
+
+- **[Getting Started Guide](docs/getting-started-guide.md)** - Complete guide to using the toolkit
+- **[Problem Anatomy](docs/problem-anatomy.md)** - Understanding problem structure and files
+- **[JutgeAI Features](docs/jutge-ai.md)** - Using AI to generate content
+
+### Installation Guides
+
+- **[Linux Installation](docs/linux-installation.md)** - Installation steps for Linux
+- **[macOS Installation](docs/macos-installation.md)** - Installation steps for macOS
+- **[Windows Installation](docs/windows-installation.md)** - Installation steps for Windows
+
+## Common Commands
+
+```bash
+# Configuration
+jtk config show                     # View current configuration
+jtk config set <key> <value>        # Set a configuration value
+jtk config edit                     # Edit configuration file
+
+# Problem Creation
+jtk clone [template]                # Clone a template problem
+jtk generate problem                # Generate problem with AI
+jtk generate translations en es ca  # Add statement translations
+jtk generate solutions python cpp   # Generate solutions in other languages
+
+# Building and Testing
+jtk make                            # Build all problem elements
+jtk make pdf                        # Generate PDF statements only
+jtk verify <program>                # Test a solution
+jtk clean                           # Clean temporary files
+
+# Publishing
+jtk upload                          # Upload problem to Jutge.org
+
+# Maintenance
+jtk upgrade                         # Update to latest version
+jtk doctor                          # Check system dependencies
+jtk about                           # Show toolkit information
+```
+
+## Requirements
+
+### Core Requirements
+- [Bun](https://bun.sh) - JavaScript runtime (required)
+
+### Optional Dependencies
+- **LaTeX** (for PDF generation) - texlive-xetex, texlive-fonts-recommended
+- **Pandoc** (for format conversion)
+- **Programming language compilers/interpreters** - Python, GCC/G++, Java, etc. (depending on your needs)
+
+Run `jtk doctor` to check which dependencies are installed on your system.
+
+## Support
+
+- **Documentation:** Check the [docs](docs/) folder for detailed guides
+- **Get Help:** Use `jtk ask "your question"` to get AI-powered assistance
+- **Issues:** Report bugs and feature requests on [GitHub Issues](https://github.com/jutge-org/jutge-toolkit/issues)
+- **Community:** Visit [Jutge.org](https://jutge.org) for the problem platform
+
+## License
+
+Copyright © Jutge.org. All rights reserved.

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,276 @@
+\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{Colors.}
+
+Colors can be used in the statement using the \texttt{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{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}

@@ -17,33 +17,38 @@
     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}
 
 %remove for xelatex
 %\usepackage{mathpazo}
 %\usepackage{helvet}
 %\usepackage{courier}
 
+\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}
 
 
-
 \geometry{
     a4paper,twoside,
     left=2.75cm,right=2.75cm,
@@ -54,10 +59,6 @@
 \setlength{\parindent}{0cm}
 \pagestyle{empty}
 
-\MakeShortVerb\|
-
-\newenvironment{NoShortVerb}{\DeleteShortVerb\|}{\MakeShortVerb\|}
-
 
 \newcommand{\mysection}[1]{\subsection*{#1}}
 
@@ -284,9 +285,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 +295,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 +315,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}
 }