Skip to content

Commit 085b183

Browse files
Abhigyan Prakashclaude
andcommitted
Add database design posts and project documentation
- Add CLAUDE.md with project setup and architecture guidelines - Add .markdownlint.json configuration - Add data-modeling-normalization and enterprise-database-design-patterns posts - Remove data-modelling-process.md Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
1 parent d2c2478 commit 085b183

5 files changed

Lines changed: 1929 additions & 1165 deletions

File tree

.markdownlint.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
{
2+
"MD024": false,
3+
"MD013": false
4+
}

CLAUDE.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# CLAUDE.md
2+
3+
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4+
5+
## Project Overview
6+
7+
Personal tech notes site built with Hugo and the PaperMod theme. Posts are written in Markdown with TOML frontmatter.
8+
9+
## Commands
10+
11+
```bash
12+
# Development server (includes drafts)
13+
hugo server -D
14+
15+
# Production build
16+
hugo --minify
17+
18+
# Create new post
19+
hugo new posts/my-post-title.md
20+
```
21+
22+
## Architecture
23+
24+
- **Theme**: PaperMod installed as git submodule in `themes/hugo-PaperMod`
25+
- **Content**: All posts go in `content/posts/` as Markdown files
26+
- **Custom layouts**: `layouts/` contains overrides for PaperMod
27+
- Mermaid diagram support via `_default/_markup/render-codeblock-mermaid.html` and `partials/extend_footer.html`
28+
- **Deployment**: GitHub Actions workflow deploys to GitHub Pages on push to `main`
29+
30+
## Post Frontmatter
31+
32+
Posts use TOML frontmatter (`+++` delimiters). Key fields:
33+
- `title`, `date`, `draft`, `tags`, `summary`
34+
- `mermaid = true` to enable Mermaid diagrams in a post
35+
- `ShowToc = false` to hide table of contents
36+
37+
## Adding Images to Posts
38+
39+
Use page bundles: create a folder with post name containing `index.md` and images:
40+
```
41+
content/posts/my-post/
42+
├── index.md
43+
└── diagram.png
44+
```

0 commit comments

Comments
 (0)