Document and add PDF page-break styles

Update README to describe the Docusaurus-based documentation site, provide development and build commands, and add instructions for generating the documentation PDF locally. Document MDX helper classes for inserting and controlling page breaks in the generated PDF. Implement corresponding CSS in scripts/pdf-style.css (.page-break, .page-break-before, .page-break-after) to enforce page breaks when exporting to PDF.

Author: alegauss

README.md

@@ -1,7 +1,59 @@
 ## Viglet Documentation
-Repository with Viglet Documentation
+
+Documentation site for Viglet products, built with [Docusaurus 3](https://docusaurus.io/).
+
+### Development
 
 ```shell
-$ cd docs
-$ bundle exec jekyll serve
+npm install
+npm start
 ```
+
+### Build
+
+```shell
+npm run build
+```
+
+### PDF Generation
+
+The documentation PDF is generated automatically during deploy. To generate locally:
+
+```shell
+npm run build
+npx docusaurus serve --no-open &
+npx wait-on http://localhost:3000/turing/getting-started/intro --timeout 60000
+npm run gen-pdf
+```
+
+#### Page Breaks in PDF
+
+Use the following classes in MDX files to control page breaks in the generated PDF. These are invisible on the website.
+
+**Force a page break at a specific point:**
+
+```mdx
+Some content before the break.
+
+<div className="page-break" />
+
+This starts on a new page in the PDF.
+```
+
+**Force an element to start on a new page:**
+
+```mdx
+<h2 className="page-break-before">New Section</h2>
+```
+
+**Force a page break after an element:**
+
+```mdx
+<div className="page-break-after">Last content on this page</div>
+```
+
+| Class | Effect |
+|---|---|
+| `page-break` | Insert a page break at that position |
+| `page-break-before` | Element starts on a new page |
+| `page-break-after` | Page break after the element |

scripts/pdf-style.css

@@ -315,3 +315,24 @@ h1, h2, h3 {
 pre, table, .admonition, blockquote {
   page-break-inside: avoid;
 }
+
+/* Manual page break — use <div className="page-break" /> in MDX */
+.page-break {
+  page-break-before: always;
+  break-before: page;
+  height: 0;
+  margin: 0;
+  padding: 0;
+}
+
+/* Force next element to start on a new page */
+.page-break-before {
+  page-break-before: always;
+  break-before: page;
+}
+
+/* Force page break after this element */
+.page-break-after {
+  page-break-after: always;
+  break-after: page;
+}