@mgks/docmd 0.2.7 → 0.2.9

package/docs/content/containers/collapsible.md

@@ -0,0 +1,89 @@
+---
+title: "Container: Collapsible"
+description: "Create accordion-style toggleable sections for FAQs, spoilers, or advanced details."
+---
+
+# Collapsible Container
+
+The `collapsible` container creates an accordion-style block that can be toggled open or closed. This is perfect for FAQs, "spoiler" content, or hiding complex details that aren't immediately necessary.
+
+## Usage
+
+The syntax allows you to define the title and the default state (open or closed).
+
+**Syntax:**
+```markdown
+::: collapsible [open] Title Text Here
+The hidden content goes here.
+:::
+```
+
+-   **`open`**: (Optional) If included, the section will be expanded by default on page load.
+-   **`Title Text Here`**: The text displayed on the clickable bar. If omitted, it defaults to "Click to expand".
+
+---
+
+## Examples
+
+### Basic Collapsible (Closed by Default)
+
+Use this for content that should be hidden initially, like lengthy code examples or optional details.
+
+**Code:**
+```markdown
+::: collapsible View Advanced Configuration
+Here are the advanced settings for power users:
+*   `memory_limit`: Set the max heap size.
+*   `threads`: Number of worker threads.
+:::
+```
+
+**Rendered Preview:**
+
+::: collapsible View Advanced Configuration
+Here are the advanced settings for power users:
+*   `memory_limit`: Set the max heap size.
+*   `threads`: Number of worker threads.
+:::
+
+### Default Open
+
+Use the `open` keyword if you want the content visible but capable of being tucked away.
+
+**Code:**
+```markdown
+::: collapsible open Important Notice
+This content is visible immediately but can be collapsed if it takes up too much space.
+:::
+```
+
+**Rendered Preview:**
+
+::: collapsible open Important Notice
+This content is visible immediately but can be collapsed if it takes up too much space.
+:::
+
+### FAQ Pattern
+
+Collapsibles are ideal for Frequently Asked Questions.
+
+**Code:**
+```markdown
+::: collapsible Is docmd free to use?
+**Yes!** docmd is 100% open-source and free under the MIT license.
+:::
+
+::: collapsible Can I host it on GitHub Pages?
+Absolutely. The `build` command generates static HTML files that work perfectly on GitHub Pages, Netlify, or Vercel.
+:::
+```
+
+**Rendered Preview:**
+
+::: collapsible Is docmd free to use?
+**Yes!** docmd is 100% open-source and free under the MIT license.
+:::
+
+::: collapsible Can I host it on GitHub Pages?
+Absolutely. The `build` command generates static HTML files that work perfectly on GitHub Pages, Netlify, or Vercel.
+:::

package/docs/content/markdown-syntax.md

@@ -197,6 +197,38 @@ docmd supports GitHub Flavored Markdown extensions including:
   
   Renders emoji symbols like: I ❤️ documentation! 🚀 😄
 
+## Custom Attributes (IDs and Classes)
+
+You can add custom IDs and CSS classes to headers, images, and links using curly braces `{}`.
+
+### Custom IDs
+By default, `docmd` generates IDs for headers automatically. You can override this:
+
+```markdown
+## My Header {#custom-id}
+```
+
+### Custom Classes
+Add styling classes to elements:
+
+```markdown
+## Styled Header {.text-center .text-red}
+```
+
+### Links and Buttons
+Create buttons using standard links and classes:
+
+```markdown
+[Download Now](/download){.btn .btn-primary}
+```
+
+### Images
+Control image styling directly:
+
+```markdown
+![Screenshot](image.png){width="100%" .shadow-lg}
+```
+
 ## Footnotes
 
 You can add footnotes to your content for references or additional information[^1].

package/docs/contributing.md

@@ -65,6 +65,14 @@ To enable live change tracking for internal files during development, set the DO
 - **Temporarily:** Run `export DOCMD_DEV=true` in your terminal before starting the dev server.
 - **Permanently:** Add `export DOCMD_DEV=true` to your `~/.zshrc` file and run `source ~/.zshrc`.
 
+### Debugging Build Issues
+
+If you are working on the build process and need to see detailed logs about asset processing or minification, you can run:
+
+```bash
+DOCMD_DEBUG=true docmd build
+```
+
 ## Pull Request Process
 
 Once you're satisfied with your changes:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mgks/docmd",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Generate beautiful, lightweight static documentation sites directly from your Markdown files. Zero clutter, just content.",
   "main": "src/index.js",
   "exports": {
@@ -42,11 +42,12 @@
   },
   "homepage": "https://github.com/mgks/docmd#readme",
   "dependencies": {
-    "@mgks/docmd": "^0.2.5",
     "chalk": "^4.1.2",
     "chokidar": "^4.0.3",
+    "clean-css": "^5.3.3",
     "commander": "^14.0.0",
     "ejs": "^3.1.9",
+    "esbuild": "^0.27.0",
     "express": "^5.1.0",
     "fs-extra": "^11.2.0",
     "gray-matter": "^4.0.3",