docs: add CHANGELOG to docs site

Author: phernandez

docs/content/docs/changelog.md

@@ -4,5 +4,100 @@ description: Latest updates and announcements.
 ---
 
 <Prose>
-Coming soon
+## v0.1.7 (2024-11-15)
+
+### Bug Fixes
+
+- Update tag for semantic-release action
+  ([`ebd48b3`](https://github.com/basicmachines-co/basic-components/commit/ebd48b3261dc9718eefd315d26a500255d8ed387))
+- Push to pypi and github. Install uv in build_command for semantic_release
+  ([`e29837f`](https://github.com/basicmachines-co/basic-components/commit/e29837f4f7b6906ce70003edd898a5cb39c313f6))
+- Add uv to docker image for release
+  ([`084c008`](https://github.com/basicmachines-co/basic-components/commit/084c00804d1fc834f1fb5a40fcc25d93ce5c99e7))
+- Redo release workflow based on python-semantic-release docs
+  ([`b03dd50`](https://github.com/basicmachines-co/basic-components/commit/b03dd504c013f8c9f1622248f43c1d7f26d92618))
+
+
+## v0.1.6 (2024-11-15)
+
+### Chores
+
+- Fix github release workflow
+  ([`2f4092e`](https://github.com/basicmachines-co/basic-components/commit/2f4092ecf68cd6d77a71d88f018783a2016c813a))
+- Update intallation docs and README
+  ([`ba44c67`](https://github.com/basicmachines-co/basic-components/commit/ba44c67df0b240301819d4e806def7bf5fc5472c))
+
+## v0.1.5 (2024-11-14)
+
+### Chores
+
+- Fix version_toml for semantic_release
+  ([`6e5ef7d`](https://github.com/basicmachines-co/basic-components/commit/6e5ef7d9364abedf40feb2e0b1a205c967aa7903))
+
+
+## v0.1.4 (2024-11-14)
+
+### Chores
+
+- Fix pyproject toml for semantic_release
+  ([`7db428a`](https://github.com/basicmachines-co/basic-components/commit/7db428a925db897e172df80136cf5d3daf7eb446))
+
+## v0.1.3 (2024-11-14)
+
+### Chores
+
+- Fix github release workflow
+  ([`6210da8`](https://github.com/basicmachines-co/basic-components/commit/6210da8d82dd4daced77560b70a3af9e1e80c408))
+
+## v0.1.2 (2024-11-14)
+
+### Chores
+
+- Add github actions release workflow
+  ([`f32e6fe`](https://github.com/basicmachines-co/basic-components/commit/f32e6fe98e5766f9403e6d35044fb801a36f4e14))
+- More doc updates for cli and utils functions
+  ([`5ad08fb`](https://github.com/basicmachines-co/basic-components/commit/5ad08fb315b71990d3af78d4f73337f9950994d2))
+
+
+## v0.1.1 (2024-11-14)
+
+### Chores
+
+- Update docs for installing, using cli
+  ([`d481aef`](https://github.com/basicmachines-co/basic-components/commit/d481aef15e36bf18ce05e21b250b14a3a7a5b7df))
+- Update llms.md for components cli tool
+  ([`a1632d8`](https://github.com/basicmachines-co/basic-components/commit/a1632d81f6466380fda41d474e8a063e59485704))
+- Update example projects
+  ([`a2981a5`](https://github.com/basicmachines-co/basic-components/commit/a2981a527e7a9f13dba7bce2e5f42a85341a7cb7))
+- More docs cleanup for installing basic-components
+  ([`7b2ac4c`](https://github.com/basicmachines-co/basic-components/commit/7b2ac4c6ab81751774b9127aa6badf6697384b36))
+- Remove Jinja from frameworks in pyproject.toml
+  ([`70554ca`](https://github.com/basicmachines-co/basic-components/commit/70554cac5c33cad2230b2db74c366a8135ca479c))
+- Update pyproject.toml and README to include dependency groups
+  ([`022d452`](https://github.com/basicmachines-co/basic-components/commit/022d4522de88d35a0bda9009d87b55ee0661e45b))
+- Add usage docs for the components cli
+  ([`fae648b`](https://github.com/basicmachines-co/basic-components/commit/fae648bd2c697dbea2908af4aa88fcba7c0fef67))
+- Upate docs for components cli
+  ([`05d6ee4`](https://github.com/basicmachines-co/basic-components/commit/05d6ee4e8fe96ea0f6f2448f5a60c1de716ae508))
+
+### Features
+
+- Integrate basic-components utilities and refactor setup
+  ([#8](https://github.com/basicmachines-co/basic-components/pull/8),
+  [`90b5d2e`](https://github.com/basicmachines-co/basic-components/commit/90b5d2e6cef39f8f4d03a1e4d2e4f0eedec9f0d8))
+* feat: integrate basic-components utilities and refactor setup
+
+Introduce `setup_component_catalog` and Tailwind utilities. Add dependency `basic-components` to
+  examples, refactor `setup_component_catalog` usage, and add `tw` to Jinja globals.
+
+* feat(tailwind): enhance class merging logic and improve docs
+
+Enhance `tw` function to handle class conflicts and maintain consistent ordering. Update
+  documentation with advanced component patterns, including state management, event handling, and
+  styling best practices.
+
+---------
+
+Co-authored-by: phernandez <phernandez@basicmachines.co>
+
 </Prose>

docs/markdown.py

@@ -7,7 +7,7 @@
 from docs.templates import templates
 
 
-def create_markdown(examples=None):
+def create_markdown():
     extensions = [
         "pymdownx.superfences",
         "pymdownx.blocks.tab",
@@ -58,6 +58,7 @@ def create_markdown(examples=None):
     }
     return markdown.Markdown(extensions=extensions, extension_configs=extension_configs)
 
+md = create_markdown()
 
 def parse_jinja_markdown(file_path: Path):
     with open(file_path, "r", encoding="utf-8") as f:
@@ -66,9 +67,7 @@ def parse_jinja_markdown(file_path: Path):
 
         metadata = post.metadata
         stripped_content = post.content
-        examples = metadata.get("examples", [])
 
-        md = create_markdown(examples=examples)
         html_content = md.convert(stripped_content)
         toc = md.toc  # pyright: ignore [reportAttributeAccessIssue]
 

docs/templates.py

@@ -5,6 +5,7 @@
 import arel
 
 import jinjax
+import markdown
 from icecream import ic
 from jinja2 import pass_context
 from jinja2.ext import DebugExtension
@@ -32,10 +33,11 @@
 
 
 @pass_context
-def include_file(context, path):
+def include_file(context, path, skip_lines=0):
     try:
         with open(Path(path), "r", encoding="utf-8") as f:
-            return f.read()
+            lines = f.readlines()
+            return ''.join(lines[skip_lines:])
     except FileNotFoundError:
         return f"<!-- {path} not found -->"
 
@@ -52,7 +54,7 @@ def filename(value):
 templates.env.globals["DEBUG"] = docs.config.settings.ENVIRONMENT == "local"
 templates.env.filters["include_file"] = include_file
 templates.env.filters["filename"] = filename
-templates.env.filters["include_file"] = include_file
+templates.env.filters["markdown"] = lambda text: markdown.Markdown().convert(text)
 templates.env.autoescape = False
 
 # Add cn to globals
@@ -74,7 +76,7 @@ def filename(value):
 def template(
     request: Request,
     name: str,
-    context: dict,
+    context: dict = {},
     status_code: int = 200,
     headers: typing.Optional[typing.Mapping[str, str]] = None,
     **kwargs,

docs/templates/components/IncludeFile.jinja

@@ -1,6 +1,6 @@
 {# def
-    dir: str,
-    file_name: str = "docs/templates",
+    dir: str = "docs/templates",
+    file_name: str,
     lang: str = "html"
 #}