Fix custom id in headers

Author: jpsca

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "writeadoc"
-version = "0.15.0"
+version = "0.16.0"
 description = "Focus on your content and let WriteADoc take care of the rest"
 authors = [
     {name = "Juan Pablo Scaletti", email = "juanpablo@jpscaletti.com"},

src/writeadoc/main.py

@@ -408,6 +408,10 @@ def warn(filename: str, lineno: int, msg: str) -> None:
                     if re.match(r"^(https?://|mailto:|tel:)", url):
                         continue
 
+                    # Skip LLM.txt references
+                    if url.startswith("/LLM.txt"):
+                        continue
+
                     # Resolve relative URLs against the page's own URL
                     if not url.startswith("/"):
                         base = page.url.rstrip("/")
@@ -441,6 +445,9 @@ def warn(filename: str, lineno: int, msg: str) -> None:
 
                     warn(filename, lineno, f"broken link: {raw_url}")
 
+        if has_warnings:
+            print()
+
     def _symlink_assets(self) -> None:
         if not self.assets_dir.exists():
             return

src/writeadoc/md/render.py

@@ -68,6 +68,8 @@ def slugify(value: str, separator: str = "-", unicode: bool = True) -> str:
 
 
 def heading_id(token: dict[str, t.Any], index: int) -> str:
+    if "id" in token.get("attrs", {}):
+        return token["attrs"]["id"]
     value = RX_ATTRS_IN_HEADER.sub("", token["text"]).strip()
     return slugify(value)
 

src/writeadoc/utils.py

@@ -58,7 +58,7 @@ def start_server(build_folder: str) -> None:
     port = 8000
     handler = partial(SimpleHTTPRequestHandler, directory=build_folder)
     server = ThreadingHTTPServer(("0.0.0.0", port), handler)
-    print(f"Serving docs on http://localhost:{port}/")
+    print(f"Serving docs on http://localhost:{port}/\n")
     try:
         server.serve_forever()
     except KeyboardInterrupt:

tests/md/test_attrs.py

@@ -74,6 +74,15 @@
 """
     ),
 
+    (  # heading with custom id
+        """
+## Hello
+{ #world }
+""",
+        """<h2 id="world">Hello</h2>
+"""
+    ),
+
     (  # thematic_break
         """
 ----