Skip to content

Commit c0afb2f

Browse files
shettigarcclaude
shettigarc
and
claude
committed
feat: add SEO tags, JSON-LD, Open Graph, and GitHub link in footer
- Add canonical URL, robots meta, Open Graph, Twitter Card to guide - Add JSON-LD TechArticle structured data to guide - Add JSON-LD WebSite structured data to index - Add GitHub repo link to footer on both index and guide pages - Document SEO requirements in style guide for future guides - Update newguide skill to include SEO and footer requirements Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 7959018 commit c0afb2f

File tree

5 files changed

+181
-9
lines changed

5 files changed

+181
-9
lines changed

‎.claude/docs/STYLE_GUIDE.md‎

Lines changed: 68 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -411,11 +411,11 @@ Search behavior rules:
411411

412412
## Footer Pattern
413413

414-
Every guide must include a footer with the Devteds attribution:
414+
Every guide must include a footer with the Devteds attribution and GitHub link:
415415

416416
```html
417417
<footer>
418-
<p>DevGuides by <a href="https://devteds.com" target="_blank">Devteds</a></p>
418+
<p>DevGuides by <a href="https://devteds.com" target="_blank">Devteds</a> &middot; <a href="https://github.com/devteds/devpages" target="_blank">GitHub</a></p>
419419
</footer>
420420
```
421421

@@ -435,3 +435,69 @@ footer a {
435435
}
436436
footer a:hover { text-decoration: underline; }
437437
```
438+
439+
---
440+
441+
## SEO Requirements
442+
443+
Every guide must include the following in `<head>` for search engine and social media optimization.
444+
445+
### Required Meta Tags
446+
447+
```html
448+
<meta name="robots" content="index, follow" />
449+
<link rel="canonical" href="https://devteds.github.io/devpages/guides/[slug]/" />
450+
```
451+
452+
### Open Graph Tags
453+
454+
```html
455+
<meta property="og:type" content="article" />
456+
<meta property="og:title" content="[Guide Title]" />
457+
<meta property="og:description" content="[Guide description from meta.json]" />
458+
<meta property="og:url" content="https://devteds.github.io/devpages/guides/[slug]/" />
459+
<meta property="og:site_name" content="DevGuides by Devteds" />
460+
<meta property="article:published_time" content="[YYYY-MM-DD]" />
461+
<meta property="article:author" content="[Author Name]" />
462+
```
463+
464+
### Twitter Card Tags
465+
466+
```html
467+
<meta name="twitter:card" content="summary" />
468+
<meta name="twitter:title" content="[Guide Title]" />
469+
<meta name="twitter:description" content="[Guide description from meta.json]" />
470+
```
471+
472+
### JSON-LD Structured Data
473+
474+
```html
475+
<script type="application/ld+json">
476+
{
477+
"@context": "https://schema.org",
478+
"@type": "TechArticle",
479+
"headline": "[Guide Title]",
480+
"description": "[Guide description]",
481+
"author": {
482+
"@type": "Person",
483+
"name": "[Author Name]",
484+
"url": "[Author URL if available]"
485+
},
486+
"publisher": {
487+
"@type": "Organization",
488+
"name": "Devteds",
489+
"url": "https://devteds.com"
490+
},
491+
"datePublished": "[YYYY-MM-DD]",
492+
"dateModified": "[YYYY-MM-DD]",
493+
"url": "https://devteds.github.io/devpages/guides/[slug]/",
494+
"keywords": ["tag1", "tag2"],
495+
"articleSection": "[category]"
496+
}
497+
</script>
498+
```
499+
500+
### Base URL
501+
502+
The GitHub Pages base URL is: `https://devteds.github.io/devpages/`
503+
All canonical and og:url values must use this base.

‎.claude/skills/newguide/SKILL.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,8 @@ HTML rules:
141141
- Include working search if guide has more than 15 items
142142
- Must render correctly via file:// and GitHub Pages
143143
- NEVER copy from a previous guide — always generate fresh from the spec
144+
- Include all SEO tags as specified in STYLE_GUIDE.md (robots, canonical, Open Graph, Twitter Card, JSON-LD)
145+
- Include a footer with Devteds attribution and GitHub link as specified in STYLE_GUIDE.md
144146

145147
For the author, read `.author.json` from the project root:
146148
```bash

‎guides/tmux-claude-cli/index.html‎

Lines changed: 43 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,48 @@
44
<meta charset="UTF-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
66
<meta name="description" content="Quick-reference cheatsheet for tmux and Claude Code CLI — shortcuts, commands, and multi-session workflows." />
7+
<meta name="robots" content="index, follow" />
8+
<link rel="canonical" href="https://devteds.github.io/devpages/guides/tmux-claude-cli/" />
9+
10+
<!-- Open Graph -->
11+
<meta property="og:type" content="article" />
12+
<meta property="og:title" content="Tmux + Claude Code CLI Cheatsheet" />
13+
<meta property="og:description" content="Quick-reference cheatsheet for tmux and Claude Code CLI — shortcuts, commands, and multi-session workflows." />
14+
<meta property="og:url" content="https://devteds.github.io/devpages/guides/tmux-claude-cli/" />
15+
<meta property="og:site_name" content="DevGuides by Devteds" />
16+
<meta property="article:published_time" content="2026-03-27" />
17+
<meta property="article:author" content="Chandra Shettigar" />
18+
19+
<!-- Twitter Card -->
20+
<meta name="twitter:card" content="summary" />
21+
<meta name="twitter:title" content="Tmux + Claude Code CLI Cheatsheet" />
22+
<meta name="twitter:description" content="Quick-reference cheatsheet for tmux and Claude Code CLI — shortcuts, commands, and multi-session workflows." />
23+
24+
<!-- JSON-LD -->
25+
<script type="application/ld+json">
26+
{
27+
"@context": "https://schema.org",
28+
"@type": "TechArticle",
29+
"headline": "Tmux + Claude Code CLI Cheatsheet",
30+
"description": "Quick-reference cheatsheet for tmux and Claude Code CLI — shortcuts, commands, and multi-session workflows.",
31+
"author": {
32+
"@type": "Person",
33+
"name": "Chandra Shettigar",
34+
"url": "https://www.linkedin.com/in/shettigarc/"
35+
},
36+
"publisher": {
37+
"@type": "Organization",
38+
"name": "Devteds",
39+
"url": "https://devteds.com"
40+
},
41+
"datePublished": "2026-03-27",
42+
"dateModified": "2026-03-27",
43+
"url": "https://devteds.github.io/devpages/guides/tmux-claude-cli/",
44+
"keywords": ["tmux", "claude-code", "cli", "terminal", "multiplexer", "ai"],
45+
"articleSection": "Developer Tools"
46+
}
47+
</script>
48+
749
<title>Tmux + Claude Code CLI Cheatsheet — DevGuides</title>
850
<link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=Syne:wght@700;800&family=Inter:wght@400;500&display=swap" rel="stylesheet" />
951
<style>
@@ -1032,7 +1074,7 @@ <h1><span class="purple">tmux</span> <span class="muted">&times;</span> <span cl
10321074
</div>
10331075

10341076
<footer>
1035-
<p>DevGuides by <a href="https://devteds.com" target="_blank">Devteds</a></p>
1077+
<p>DevGuides by <a href="https://devteds.com" target="_blank">Devteds</a> &middot; <a href="https://github.com/devteds/devpages" target="_blank">GitHub</a></p>
10361078
</footer>
10371079

10381080
</div><!-- .wrap -->

‎index.html‎

Lines changed: 34 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,39 @@
33
<head>
44
<meta charset="UTF-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
6-
<meta name="description" content="DevPages — A developer knowledge publishing hub." />
7-
<title>DevPages</title>
6+
<meta name="description" content="DevGuides — Developer knowledge guides published by Devteds. Cheatsheets, tutorials, and references for modern dev tools." />
7+
<meta name="robots" content="index, follow" />
8+
<link rel="canonical" href="https://devteds.github.io/devpages/" />
9+
10+
<!-- Open Graph -->
11+
<meta property="og:type" content="website" />
12+
<meta property="og:title" content="DevGuides by Devteds" />
13+
<meta property="og:description" content="Developer knowledge guides — cheatsheets, tutorials, and references for modern dev tools." />
14+
<meta property="og:url" content="https://devteds.github.io/devpages/" />
15+
<meta property="og:site_name" content="DevGuides by Devteds" />
16+
17+
<!-- Twitter Card -->
18+
<meta name="twitter:card" content="summary" />
19+
<meta name="twitter:title" content="DevGuides by Devteds" />
20+
<meta name="twitter:description" content="Developer knowledge guides — cheatsheets, tutorials, and references for modern dev tools." />
21+
22+
<!-- JSON-LD -->
23+
<script type="application/ld+json">
24+
{
25+
"@context": "https://schema.org",
26+
"@type": "WebSite",
27+
"name": "DevGuides",
28+
"description": "Developer knowledge guides published by Devteds",
29+
"url": "https://devteds.github.io/devpages/",
30+
"publisher": {
31+
"@type": "Organization",
32+
"name": "Devteds",
33+
"url": "https://devteds.com"
34+
}
35+
}
36+
</script>
37+
38+
<title>DevGuides by Devteds</title>
839
<link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=Syne:wght@700;800&family=Inter:wght@400;500&display=swap" rel="stylesheet" />
940
<style>
1041
:root {
@@ -289,7 +320,7 @@ <h3 class="guide-title">Tmux + Claude Code CLI Cheatsheet</h3>
289320
</div>
290321

291322
<footer>
292-
DevGuides by <a href="https://devteds.com" target="_blank">Devteds</a>
323+
DevGuides by <a href="https://devteds.com" target="_blank">Devteds</a> &middot; <a href="https://github.com/devteds/devpages" target="_blank">GitHub</a>
293324
</footer>
294325
</div>
295326

‎scripts/build-index.js‎

Lines changed: 34 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -101,8 +101,39 @@ function generateIndexHtml(guides) {
101101
<head>
102102
<meta charset="UTF-8" />
103103
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
104-
<meta name="description" content="DevPages — A developer knowledge publishing hub." />
105-
<title>DevPages</title>
104+
<meta name="description" content="DevGuides — Developer knowledge guides published by Devteds. Cheatsheets, tutorials, and references for modern dev tools." />
105+
<meta name="robots" content="index, follow" />
106+
<link rel="canonical" href="https://devteds.github.io/devpages/" />
107+
108+
<!-- Open Graph -->
109+
<meta property="og:type" content="website" />
110+
<meta property="og:title" content="DevGuides by Devteds" />
111+
<meta property="og:description" content="Developer knowledge guides — cheatsheets, tutorials, and references for modern dev tools." />
112+
<meta property="og:url" content="https://devteds.github.io/devpages/" />
113+
<meta property="og:site_name" content="DevGuides by Devteds" />
114+
115+
<!-- Twitter Card -->
116+
<meta name="twitter:card" content="summary" />
117+
<meta name="twitter:title" content="DevGuides by Devteds" />
118+
<meta name="twitter:description" content="Developer knowledge guides — cheatsheets, tutorials, and references for modern dev tools." />
119+
120+
<!-- JSON-LD -->
121+
<script type="application/ld+json">
122+
{
123+
"@context": "https://schema.org",
124+
"@type": "WebSite",
125+
"name": "DevGuides",
126+
"description": "Developer knowledge guides published by Devteds",
127+
"url": "https://devteds.github.io/devpages/",
128+
"publisher": {
129+
"@type": "Organization",
130+
"name": "Devteds",
131+
"url": "https://devteds.com"
132+
}
133+
}
134+
</script>
135+
136+
<title>DevGuides by Devteds</title>
106137
<link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=Syne:wght@700;800&family=Inter:wght@400;500&display=swap" rel="stylesheet" />
107138
<style>
108139
:root {
@@ -371,7 +402,7 @@ ${guides.length > 0 ? guideCardsHtml : emptyStateHtml}
371402
</div>
372403
373404
<footer>
374-
DevGuides by <a href="https://devteds.com" target="_blank">Devteds</a>
405+
DevGuides by <a href="https://devteds.com" target="_blank">Devteds</a> &middot; <a href="https://github.com/devteds/devpages" target="_blank">GitHub</a>
375406
</footer>
376407
</div>
377408

0 commit comments

Comments
 (0)