[Docs/API] Complete documentation and expand Python cache bindings

.gitignore

@@ -153,6 +153,7 @@ venv.bak/
 
 # mkdocs documentation
 /site
+docs/site/
 
 # mypy
 .mypy_cache/
@@ -232,4 +233,5 @@ sftp-config.json
 CMakeFiles/*
 *.pyc
 !scripts/smart_build.py
-uv.lock
+uv.lock
+.claude/

CMakeLists.txt

@@ -274,7 +274,14 @@ set_target_properties(libcachesim_python PROPERTIES
     INSTALL_RPATH "$ORIGIN"
 )
 
-target_compile_definitions(libcachesim_python PRIVATE VERSION_INFO=${PROJECT_VERSION})
+if(DEFINED SKBUILD_PROJECT_VERSION AND NOT SKBUILD_PROJECT_VERSION STREQUAL "")
+    set(LCS_PYTHON_VERSION ${SKBUILD_PROJECT_VERSION})
+else()
+    set(LCS_PYTHON_VERSION "dev")
+endif()
+message(STATUS "libcachesim_python version: ${LCS_PYTHON_VERSION}")
+
+target_compile_definitions(libcachesim_python PRIVATE VERSION_INFO=${LCS_PYTHON_VERSION})
 
 # =============================================================================
 # Platform-Specific Configuration

docs/mkdocs.yml

@@ -9,9 +9,9 @@ docs_dir: src
 nav:
   - Home: 
     - libCacheSim Python: index.md
-    - Getting Started: 
-      - getting_started/quickstart.md
+    - Getting Started:
       - getting_started/installation.md
+      - getting_started/quickstart.md
     - Examples:
       - examples/reader.md
       - examples/simulation.md
@@ -85,11 +85,14 @@ plugins:
           build: true
           nav_translations:
             Home: 首页
-            Getting Started: 快速开始
+            Getting Started: 入门指南
             User Guide: 用户指南
             Developer Guide: 开发者指南
             API Reference: API参考
             Examples: 使用示例
+            FAQ: 常见问题
+            General: 总览
+            API Documentation: API 文档
 
 markdown_extensions:
   - attr_list