Test User
132 lines
2.2 KiB
Markdown
132 lines
2.2 KiB
Markdown
---
|
|
title: Madomeda Usage Examples
|
|
created: '2025-10-23T18:33:48+02:00'
|
|
status: draft
|
|
priority: 5
|
|
published: false
|
|
tags: []
|
|
reviewers: []
|
|
---
|
|
# Madomeda Usage Examples
|
|
|
|
## Basic Usage
|
|
|
|
Process the current directory:
|
|
```bash
|
|
python madomeda.py
|
|
```
|
|
|
|
## Dry Run Mode
|
|
|
|
Preview changes without modifying files:
|
|
```bash
|
|
python madomeda.py --whatif
|
|
```
|
|
|
|
## Specify Directory
|
|
|
|
Process a specific repository:
|
|
```bash
|
|
python madomeda.py --dir /path/to/repo
|
|
```
|
|
|
|
## Force Update
|
|
|
|
Re-process all files regardless of conformance:
|
|
```bash
|
|
python madomeda.py --force
|
|
```
|
|
|
|
## Skip Confirmation
|
|
|
|
Automatically accept metadata discards:
|
|
```bash
|
|
python madomeda.py --no-confirm
|
|
```
|
|
|
|
## Ignore Paths
|
|
|
|
Exclude specific paths from processing:
|
|
```bash
|
|
python madomeda.py --ignore-paths docs/archive vendor/external
|
|
```
|
|
|
|
## Custom Template
|
|
|
|
Use a specific template:
|
|
```bash
|
|
python madomeda.py --template my-template
|
|
```
|
|
|
|
## Example: Tag Normalization
|
|
|
|
**Before:**
|
|
```yaml
|
|
---
|
|
Title: My Document
|
|
Tag: Python, Machine-Learning, Data Science
|
|
Summary: A comprehensive guide
|
|
---
|
|
```
|
|
|
|
**After (regular mode):**
|
|
```yaml
|
|
---
|
|
title: My Document
|
|
created: '2025-10-23T17:27:16+02:00'
|
|
changed: '2025-10-23T17:27:16+02:00'
|
|
authors:
|
|
- John Doe
|
|
version: 34d2d05
|
|
tags:
|
|
- python
|
|
- machine_learning
|
|
- data_science
|
|
---
|
|
```
|
|
|
|
**After (--add-only mode):**
|
|
```yaml
|
|
---
|
|
title: My Document
|
|
description: A comprehensive guide
|
|
created: '2025-10-23T17:27:16+02:00'
|
|
changed: '2025-10-23T17:27:16+02:00'
|
|
authors:
|
|
- John Doe
|
|
version: 34d2d05
|
|
tags:
|
|
- python
|
|
- machine_learning
|
|
- data_science
|
|
---
|
|
```
|
|
Note: In add-only mode, "Summary" becomes "description" (normalized), and all template fields are added.
|
|
|
|
## Database Inspection
|
|
|
|
The SQLite database (`madomeda.db`) contains:
|
|
- File tracking
|
|
- Frontmatter versions
|
|
- Git commit information
|
|
- Unique tags repository
|
|
|
|
Query example:
|
|
```python
|
|
import sqlite3
|
|
conn = sqlite3.connect('madomeda.db')
|
|
cursor = conn.cursor()
|
|
cursor.execute('SELECT tag FROM tags ORDER BY tag')
|
|
tags = [row[0] for row in cursor.fetchall()]
|
|
print(tags)
|
|
```
|
|
|
|
## Changelog
|
|
|
|
All changes are logged to `madomeda_changelog.txt`:
|
|
```
|
|
2025-10-23 17:40:36 (commit: 34d2d054afff9f679468f2d662bf9b8eb9754b82)
|
|
sample.md - frontmatter updated
|
|
test.md - frontmatter updated
|
|
```
|