feat: add example script and update documentation for clarity

Author: ya7010

docs/docs/contributing.md

@@ -6,7 +6,7 @@ We welcome contributions to TPPT! This document provides guidelines and instruct
 
 1. Fork and clone the repository:
 ```bash
-git clone https://github.com/yourusername/tppt.git
+git clone https://github.com/yassun7010/tppt.git
 cd tppt
 ```
 

docs/docs/examples/simple.py

@@ -0,0 +1,18 @@
+import tppt
+
+(
+    tppt.Presentation.builder()
+    .slide(
+        lambda slide: slide.BlankLayout()
+        .builder()
+        .text(
+            "Hello, World!",
+            left=(1, "in"),
+            top=(1, "in"),
+            width=(5, "in"),
+            height=(2, "in"),
+        )
+    )
+    .build()
+    .save("simple.pptx")
+)

docs/docs/index.md

@@ -12,20 +12,7 @@ TPPT (Typed Python PowerPoint Tool) is a Python library for creating and manipul
 ## Quick Start
 
 ```python
-from tppt import Presentation
-
-# Create a new presentation
-presentation = Presentation()
-
-# Add a slide
-slide = presentation.add_slide()
-
-# Add content to the slide
-slide.add_title("Hello, World!")
-slide.add_text("This is a sample slide.")
-
-# Save the presentation
-presentation.save("example.pptx")
+--8<-- "docs/examples/simple.py"
 ```
 
 ## Getting Started

docs/mkdocs.yml

@@ -54,7 +54,8 @@ markdown_extensions:
   - pymdownx.highlight:
       anchor_linenums: true
   - pymdownx.inlinehilite
-  - pymdownx.snippets
+  - pymdownx.snippets:
+      base_path: docs
   - pymdownx.superfences
   - pymdownx.tabbed:
       alternate_style: true

pyproject.toml

@@ -54,6 +54,7 @@ docs = [
   "mkdocs>=1.6.1",
   "mkdocstrings-python>=1.10.0",
   "mkdocstrings>=0.25.0",
+  "pymdown-extensions>=10.15",
 ]
 rich = ["rich", "rich-argparse"]