awilum/sql-introduction

This repository holds the source material for an educational book called "SQL Introduction." The book teaches relational databases and SQL from the ground up, based on a practical course. It is meant to help learners pick up these concepts step by step. What makes this project more than a collection of text files is its automated build system. The content is written in Markdown, a simple plain text format, and organized into chapters and sections. Build scripts then take that content and generate finished book files in formats like PDF and EPUB, which are the types of files you would use on an e-reader or print out. A program called Pandoc handles this conversion, with help from another tool called Typst. The repository is structured to keep things tidy. There is a folder for the Russian version of the book, containing the actual chapter files, images, metadata like the title and author, and a template that controls how the final document looks. A separate scripts folder holds the build programs. When someone runs the main build script, the software reads all the chapter files and produces the final books, placing them in an output folder that is not stored in the repository itself. To use this setup, a person needs Pandoc, Typst, and a Bash environment, which typically means a Mac or Linux computer. The process is straightforward: you run a single script, and the output appears in the designated folder. This project is mainly for people who want to study SQL or for anyone interested in how a book can be assembled from plain text files.