|
1
|
{% extends "base.html" %} |
|
2
|
{% block title %}FossilSCM Guide — Fossilrepo{% endblock %} |
|
3
|
|
|
4
|
{% block content %} |
|
5
|
<div class="max-w-4xl"> |
|
6
|
<h1 class="text-2xl font-bold text-gray-100 mb-2">FossilSCM Guide</h1> |
|
7
|
<p class="text-sm text-gray-400 mb-4">Reference documentation for Fossil SCM, bundled with your FossilRepo installation.</p> |
|
8
|
|
|
9
|
<div class="flex items-center gap-4 text-xs text-gray-500 mb-6"> |
|
10
|
<span class="flex items-center gap-1.5"><span class="inline-block w-2 h-2 rounded-full bg-green-500"></span> Supported in FossilRepo</span> |
|
11
|
<span class="flex items-center gap-1.5"><span class="inline-block w-2 h-2 rounded-full bg-yellow-500"></span> Partial support</span> |
|
12
|
<span class="flex items-center gap-1.5"><span class="inline-block w-2 h-2 rounded-full bg-gray-600"></span> Not yet supported</span> |
|
13
|
</div> |
|
14
|
|
|
15
|
<div class="grid grid-cols-1 gap-4 sm:grid-cols-2"> |
|
16
|
|
|
17
|
<div class="rounded-lg bg-gray-800 border border-gray-700 p-5"> |
|
18
|
<h3 class="text-sm font-semibold text-gray-200 mb-3 uppercase tracking-wider">Getting Started</h3> |
|
19
|
<div class="space-y-2"> |
|
20
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/quickstart.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
21
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Quick Start Guide</a> |
|
22
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/build.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
23
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Building from Source</a> |
|
24
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/concepts.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
25
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Core Concepts</a> |
|
26
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/faq.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
27
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> FAQ</a> |
|
28
|
</div> |
|
29
|
</div> |
|
30
|
|
|
31
|
<div class="rounded-lg bg-gray-800 border border-gray-700 p-5"> |
|
32
|
<h3 class="text-sm font-semibold text-gray-200 mb-3 uppercase tracking-wider">Version Control</h3> |
|
33
|
<div class="space-y-2"> |
|
34
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/checkin.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
35
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Check-in Overview</a> |
|
36
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/branching.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
37
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Branching</a> |
|
38
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/merge.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
39
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Merging</a> |
|
40
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/delta_format.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
41
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Delta Format</a> |
|
42
|
</div> |
|
43
|
</div> |
|
44
|
|
|
45
|
<div class="rounded-lg bg-gray-800 border border-gray-700 p-5"> |
|
46
|
<h3 class="text-sm font-semibold text-gray-200 mb-3 uppercase tracking-wider">Built-in Features</h3> |
|
47
|
<div class="space-y-2"> |
|
48
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/wikitheory.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
49
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Wiki</a> |
|
50
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/tickets.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
51
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Ticket System</a> |
|
52
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/forum.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
53
|
<span class="w-2 h-2 rounded-full bg-yellow-500 flex-shrink-0"></span> Forum |
|
54
|
<span class="text-xs text-gray-500">(read from Fossil + Django write)</span></a> |
|
55
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/alerts.md' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
56
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Email Alerts</a> |
|
57
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/chat.md' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
58
|
<span class="w-2 h-2 rounded-full bg-gray-600 flex-shrink-0"></span> Chat |
|
59
|
<span class="text-xs text-gray-500">(not yet — multiple approaches under evaluation)</span></a> |
|
60
|
</div> |
|
61
|
</div> |
|
62
|
|
|
63
|
<div class="rounded-lg bg-gray-800 border border-gray-700 p-5"> |
|
64
|
<h3 class="text-sm font-semibold text-gray-200 mb-3 uppercase tracking-wider">Administration</h3> |
|
65
|
<div class="space-y-2"> |
|
66
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/server/index.md' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
67
|
<span class="w-2 h-2 rounded-full bg-yellow-500 flex-shrink-0"></span> Server Setup |
|
68
|
<span class="text-xs text-gray-500">(FossilRepo replaces native server)</span></a> |
|
69
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/sync.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
70
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Sync Protocol</a> |
|
71
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/backup.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
72
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Backups</a> |
|
73
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/fileformat.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
74
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> File Format</a> |
|
75
|
</div> |
|
76
|
</div> |
|
77
|
|
|
78
|
<div class="rounded-lg bg-gray-800 border border-gray-700 p-5 sm:col-span-2"> |
|
79
|
<h3 class="text-sm font-semibold text-gray-200 mb-3 uppercase tracking-wider">Reference</h3> |
|
80
|
<div class="grid grid-cols-1 sm:grid-cols-2 gap-2"> |
|
81
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/changes.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
82
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Changelog</a> |
|
83
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/permutedindex.html' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
84
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Command Reference</a> |
|
85
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/th1.md' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
86
|
<span class="w-2 h-2 rounded-full bg-gray-600 flex-shrink-0"></span> TH1 Scripting |
|
87
|
<span class="text-xs text-gray-500">(native Fossil only)</span></a> |
|
88
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/fossil-v-git.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
89
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Fossil vs Git</a> |
|
90
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/hashpolicy.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
91
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Hash Policy</a> |
|
92
|
<a href="{% url 'fossil:doc_page' slug=fossil_scm_slug doc_path='www/embeddeddoc.wiki' %}" class="flex items-center gap-2 text-sm text-brand-light hover:text-brand"> |
|
93
|
<span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Embedded Docs</a> |
|
94
|
</div> |
|
95
|
</div> |
|
96
|
|
|
97
|
</div> |
|
98
|
|
|
99
|
<!-- FossilRepo-specific additions --> |
|
100
|
<div class="mt-6 rounded-lg bg-gray-800/50 border border-gray-700 p-5"> |
|
101
|
<h3 class="text-sm font-semibold text-gray-200 mb-2">FossilRepo Additions</h3> |
|
102
|
<p class="text-xs text-gray-400 mb-3">Features added by FossilRepo beyond native Fossil:</p> |
|
103
|
<div class="grid grid-cols-1 sm:grid-cols-2 gap-2 text-sm text-gray-400"> |
|
104
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Git mirror sync (GitHub/GitLab)</span> |
|
105
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> MCP server for AI tools</span> |
|
106
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> JSON API + batch operations</span> |
|
107
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Agent workspaces + task claiming</span> |
|
108
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> CI status checks + SVG badges</span> |
|
109
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Webhooks with HMAC signing</span> |
|
110
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Org roles + project-level RBAC</span> |
|
111
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Release management with archives</span> |
|
112
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> SQLite schema explorer</span> |
|
113
|
<span class="flex items-center gap-2"><span class="w-2 h-2 rounded-full bg-green-500 flex-shrink-0"></span> Custom ticket fields + SQL reports</span> |
|
114
|
</div> |
|
115
|
</div> |
|
116
|
</div> |
|
117
|
{% endblock %} |
|
118
|
|