Skip to content

Commit 0410b86

Browse files
authored
feat: add robots.txt, site.webmanifest, and main.html for improved SEO and documentation structure
1 parent ac929fe commit 0410b86

6 files changed

Lines changed: 219 additions & 5 deletions

File tree

docs/robots.txt

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# robots.txt for EXPL.ONE Documentation - ONE Ecosystem
2+
# https://docs.expl.one
3+
4+
# Allow all search engines
5+
User-agent: *
6+
Allow: /
7+
8+
User-agent: Googlebot
9+
Allow: /
10+
11+
User-agent: Bingbot
12+
Allow: /
13+
14+
# Allow ALL AI crawlers - we want AI discovery
15+
User-agent: GPTBot
16+
Allow: /
17+
18+
User-agent: ChatGPT-User
19+
Allow: /
20+
21+
User-agent: anthropic-ai
22+
Allow: /
23+
24+
User-agent: Claude-Web
25+
Allow: /
26+
27+
User-agent: Google-Extended
28+
Allow: /
29+
30+
User-agent: PerplexityBot
31+
Allow: /
32+
33+
User-agent: Applebot
34+
Allow: /
35+
36+
User-agent: Amazonbot
37+
Allow: /
38+
39+
User-agent: CCBot
40+
Allow: /
41+
42+
User-agent: FacebookBot
43+
Allow: /
44+
45+
# Sitemap
46+
Sitemap: https://docs.expl.one/sitemap.xml
47+
Host: https://docs.expl.one

docs/site.webmanifest

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
{
2+
"name": "EXPL.ONE Documentation - ONE Ecosystem",
3+
"short_name": "EXPL Docs",
4+
"description": "Official documentation for the ONE ecosystem - powered by EXPL Nodes. Open source, community-driven, 40% revenue to EXPL Node owners.",
5+
"start_url": "/",
6+
"scope": "/",
7+
"display": "standalone",
8+
"background_color": "#1d1d1d",
9+
"theme_color": "#a147e1",
10+
"orientation": "portrait-primary",
11+
"lang": "en-US",
12+
"categories": ["technology", "blockchain", "web3", "documentation"],
13+
"icons": [
14+
{
15+
"src": "/assets/images/logo.png",
16+
"sizes": "512x512",
17+
"type": "image/png",
18+
"purpose": "any maskable"
19+
}
20+
]
21+
}

docs/stylesheets/extra.css

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,21 @@
1-
/* Custom Explorills Theme - Dark Mode Only */
1+
/* Custom EXPL.ONE Theme - Dark Mode Only */
22

33
/* Import Roboto font */
44
@import url('https://fonts.googleapis.com/css2?family=Roboto:wght@300;400;500;700&display=swap');
55

6+
/* Screen-reader only class for SEO H1 tags */
7+
.sr-only {
8+
position: absolute;
9+
width: 1px;
10+
height: 1px;
11+
padding: 0;
12+
margin: -1px;
13+
overflow: hidden;
14+
clip: rect(0, 0, 0, 0);
15+
white-space: nowrap;
16+
border: 0;
17+
}
18+
619
/* Root color variables */
720
:root {
821
--md-primary-fg-color: #a147e1;

mkdocs.yml

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,17 @@
11
site_name: EXPL.ONE Documentation
22
site_url: https://docs.expl.one
3-
site_description: Official documentation for the ONE ecosystem - powered by EXPL Nodes and the $EXPL token
4-
site_author: EXPL.ONE
3+
site_description: Official documentation for the ONE ecosystem - powered by EXPL Nodes. Open source, community-driven, 40% revenue to EXPL Node owners.
4+
site_author: EXPL.ONE Team
55
repo_url: https://github.com/explorills/docs
66
repo_name: explorills/docs
77

8+
# SEO and Analytics
9+
plugins:
10+
- search:
11+
separator: '[\s\-,:!=\[\]()"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'
12+
- minify:
13+
minify_html: true
14+
815
theme:
916
name: material
1017
custom_dir: overrides
@@ -57,6 +64,9 @@ extra_javascript:
5764
- javascripts/extra.js
5865

5966
extra:
67+
analytics:
68+
provider: google
69+
property: G-3NM3XM3TX2
6070
social:
6171
- icon: fontawesome/brands/github
6272
link: https://github.com/explorills

overrides/404.html

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<h1>404 - Page Not Found</h1>
77

88
<div style="text-align: center; margin: 40px 0;">
9-
<img src="/assets/images/logo.png" alt="Explorills Logo" width="150" />
9+
<img src="/assets/images/logo.png" alt="EXPL.ONE Logo" width="150" />
1010
</div>
1111

1212
<hr>
@@ -38,7 +38,8 @@ <h2>Quick Navigation</h2>
3838
<p class="admonition-title">Contact Us</p>
3939
<p>Need help? Reach out to our support team:</p>
4040
<ul>
41-
<li><strong>Email</strong>: <a href="mailto:support@explorills.com" target="_blank">support@explorills.com</a></li>
41+
<li><strong>Email</strong>: <a href="mailto:support@expl.one" target="_blank">support@expl.one</a></li>
42+
<li><strong>Discord</strong>: <a href="https://discord.gg/jaZ23J3NCc" target="_blank" rel="noopener noreferrer">Join our community</a></li>
4243
</ul>
4344
</div>
4445
</article>

overrides/main.html

Lines changed: 122 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
{% extends "base.html" %}
2+
3+
{% block extrahead %}
4+
<!-- Google Analytics 4 - ONE Ecosystem -->
5+
<script async src="https://www.googletagmanager.com/gtag/js?id=G-3NM3XM3TX2"></script>
6+
<script>
7+
window.dataLayer = window.dataLayer || [];
8+
function gtag(){dataLayer.push(arguments);}
9+
gtag('js', new Date());
10+
gtag('config', 'G-3NM3XM3TX2');
11+
</script>
12+
13+
<!-- Primary Meta Tags -->
14+
<meta name="title" content="{{ config.site_name }}" />
15+
<meta name="author" content="EXPL.ONE Team" />
16+
<meta name="keywords" content="EXPL Nodes, ONE ecosystem, web3, blockchain, crypto, decentralized, open source, documentation, EXPL token" />
17+
<meta name="robots" content="index, follow, max-image-preview:large, max-video-preview:-1" />
18+
<meta name="theme-color" content="#a147e1" />
19+
<meta name="color-scheme" content="dark" />
20+
21+
<!-- Canonical URL -->
22+
<link rel="canonical" href="{{ config.site_url }}{{ page.url }}" />
23+
24+
<!-- Language -->
25+
<meta property="og:locale" content="en_US" />
26+
<link rel="alternate" hreflang="en" href="{{ config.site_url }}" />
27+
<link rel="alternate" hreflang="x-default" href="{{ config.site_url }}" />
28+
29+
<!-- Open Graph -->
30+
<meta property="og:type" content="website" />
31+
<meta property="og:url" content="{{ config.site_url }}{{ page.url }}" />
32+
<meta property="og:site_name" content="{{ config.site_name }}" />
33+
<meta property="og:title" content="{% if page.title %}{{ page.title }} - {% endif %}{{ config.site_name }}" />
34+
<meta property="og:description" content="{{ config.site_description }}" />
35+
<meta property="og:image" content="{{ config.site_url }}assets/images/logo.png" />
36+
<meta property="og:image:width" content="512" />
37+
<meta property="og:image:height" content="512" />
38+
<meta property="og:image:alt" content="EXPL.ONE Documentation - ONE Ecosystem" />
39+
40+
<!-- Twitter Card -->
41+
<meta name="twitter:card" content="summary_large_image" />
42+
<meta name="twitter:site" content="@explorills_main" />
43+
<meta name="twitter:creator" content="@explorills_main" />
44+
<meta name="twitter:url" content="{{ config.site_url }}{{ page.url }}" />
45+
<meta name="twitter:title" content="{% if page.title %}{{ page.title }} - {% endif %}{{ config.site_name }}" />
46+
<meta name="twitter:description" content="{{ config.site_description }}" />
47+
<meta name="twitter:image" content="{{ config.site_url }}assets/images/logo.png" />
48+
49+
<!-- PWA Manifest -->
50+
<link rel="manifest" href="{{ config.site_url }}site.webmanifest" />
51+
52+
<!-- Preconnect -->
53+
<link rel="preconnect" href="https://fonts.googleapis.com" />
54+
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
55+
<link rel="preconnect" href="https://www.googletagmanager.com" />
56+
57+
<!-- Structured Data: Organization -->
58+
<script type="application/ld+json">
59+
{
60+
"@context": "https://schema.org",
61+
"@type": "Organization",
62+
"@id": "https://expl.one/#organization",
63+
"name": "EXPL.ONE",
64+
"url": "https://expl.one",
65+
"logo": "https://expl.one/logo.png",
66+
"sameAs": [
67+
"https://github.com/explorills",
68+
"https://x.com/explorills_main",
69+
"https://discord.com/invite/RetTCVq7tJ"
70+
]
71+
}
72+
</script>
73+
74+
<!-- Structured Data: WebSite -->
75+
<script type="application/ld+json">
76+
{
77+
"@context": "https://schema.org",
78+
"@type": "WebSite",
79+
"@id": "https://docs.expl.one/#website",
80+
"name": "EXPL.ONE Documentation",
81+
"url": "https://docs.expl.one",
82+
"description": "Official documentation for the ONE ecosystem - powered by EXPL Nodes. Open source, community-driven, 40% revenue to EXPL Node owners.",
83+
"publisher": {
84+
"@id": "https://expl.one/#organization"
85+
},
86+
"isPartOf": {
87+
"@id": "https://expl.one/#website"
88+
},
89+
"inLanguage": "en-US"
90+
}
91+
</script>
92+
93+
<!-- Structured Data: BreadcrumbList -->
94+
<script type="application/ld+json">
95+
{
96+
"@context": "https://schema.org",
97+
"@type": "BreadcrumbList",
98+
"itemListElement": [
99+
{
100+
"@type": "ListItem",
101+
"position": 1,
102+
"name": "ONE Ecosystem",
103+
"item": "https://expl.one/"
104+
},
105+
{
106+
"@type": "ListItem",
107+
"position": 2,
108+
"name": "Documentation",
109+
"item": "https://docs.expl.one/"
110+
}
111+
{% if page.title and page.url != "/" %}
112+
,{
113+
"@type": "ListItem",
114+
"position": 3,
115+
"name": "{{ page.title }}",
116+
"item": "{{ config.site_url }}{{ page.url }}"
117+
}
118+
{% endif %}
119+
]
120+
}
121+
</script>
122+
{% endblock %}

0 commit comments

Comments
 (0)