README.md

exam-ltr – Create Professional Exams with Ease

exam-ltr is a LaTeX package that helps you create beautiful, professional exams without worrying about formatting. Just write your questions naturally, and the package takes care of numbering, layout, and answer keys.

Whether you're a teacher preparing a quiz or an exam setter creating a comprehensive test, this package makes your job easier.

✨ Key Features

• 8 Question Types: Multiple Choice, True/False, Fill in the Blank, Ordering, Matching, Essay, Short Answer, and Reading Passage.
• Automatic Answer Keys: Answers are collected and displayed automatically in teacher mode.
• Smart Randomization: Shuffles options and matching items in a reproducible way.
• Clean Output: Student version has no hints; teacher version shows full answers.
• Simple to Use: Write your questions in plain LaTeX, and the package handles the rest.

🚀 Getting Started in 3 Steps

1. Load the Package

\documentclass{article}
\usepackage{exam-ltr}

1. Set the Mode

\TeacherMode
\ShowCorrection
\ExamID{1234}

1. Write Your Questions

\begin{Question}{MC}{Easy}{2}{Choose the correct answer}
\begin{MC}
    \MCQuestion{What is 2+2?}{2}
        \MCOption{3}
        \MCOption{4}
        \MCOption{5}
\end{MC}
\end{Question}

That's it! Compile and you have a complete exam with an answer key.

📦 Installation

The package is available on CTAN and included in all major LaTeX distributions (TeX Live, MiKTeX, MacTeX). Just use it — your system will handle the rest.

If you need to install manually: Place exam-ltr.sty in your working directory, or install it permanently using your local texmf tree.

🎯 Quick Overview of Commands

📝 Question Types at a Glance

📚 Need More Details?

• Check the example.tex file included with the package.
• Read the full documentation exam-ltr.pdf for detailed explanations and examples.

📄 License

This package is distributed under the LaTeX Project Public License (LPPL), version 1.3c or later.

👤 Author

Nadeer Aljaroudi

Happy Exam Writing! 😊