From 1c263708230b75d5cf2b67c50ea8c38c6a13b3d2 Mon Sep 17 00:00:00 2001 From: Dongho Kim Date: Thu, 4 Dec 2025 11:09:39 +0100 Subject: [PATCH] first commit --- README.md | 73 ++ asset/snap1.png | Bin 0 -> 788367 bytes custom/public/css/home.css | 1 + custom/templates/custom/body_inner_post.tmpl | 165 +++ custom/templates/custom/footer.tmpl | 33 + custom/templates/custom/header.tmpl | 1014 ++++++++++++++++++ custom/templates/home.tmpl | 157 +++ preview-guest.html | 839 +++++++++++++++ preview-signed-in.html | 712 ++++++++++++ 9 files changed, 2994 insertions(+) create mode 100644 README.md create mode 100644 asset/snap1.png create mode 100644 custom/public/css/home.css create mode 100644 custom/templates/custom/body_inner_post.tmpl create mode 100644 custom/templates/custom/footer.tmpl create mode 100644 custom/templates/custom/header.tmpl create mode 100644 custom/templates/home.tmpl create mode 100644 preview-guest.html create mode 100644 preview-signed-in.html diff --git a/README.md b/README.md new file mode 100644 index 0000000..43ba2e5 --- /dev/null +++ b/README.md @@ -0,0 +1,73 @@ +# Gitea Bootstrap 5 Landing Page Theme + +A drop-in theme that replaces the public front page of a Gitea instance with a modern Bootstrap 5 + Font Awesome experience. Signed-in users see a refreshed quick-action dashboard row, while guests get a marketing-style hero layout with prominent calls to action. + +![Screenshot of the customized Gitea home landing page showing the Bootstrap hero layout, quick actions, and footer enhancements](asset/snap1.png) + +## What's Included + +- `custom/templates/home.tmpl` – overrides the default landing page with a Bootstrap 5 design +- `custom/templates/custom/header.tmpl` – injects Bootstrap, Font Awesome, typography, and inlined theme styles +- `custom/templates/custom/body_inner_pre.tmpl` – adds a compact promotional banner above the navigation bar +- `custom/templates/custom/footer.tmpl` – delivers a multi-column footer with curated resource links + +## Prerequisites + +- Gitea 1.18+ (tested against the current `main` template structure) +- Access to the `custom/` directory on your Alpine Linux host (default `/var/lib/gitea/custom` when using the official packages) + +## Installation + +1. **Stop Gitea (optional but safest):** + ```sh + sudo rc-service gitea stop + ``` +2. **Copy the theme files:** + ```sh + sudo rsync -av custom/ /var/lib/gitea/custom/ + ``` + Adjust the destination path if your `APP_DATA_PATH` differs. +3. **Fix permissions:** + ```sh + sudo chown -R git:git /var/lib/gitea/custom + ``` + Replace `git:git` with the user/group running your Gitea service. +4. **Start or restart Gitea:** + ```sh + sudo rc-service gitea start + ``` +5. **Bust caches (optional but recommended):** add or increment `ui.asset_version` in `app.ini`, or clear `$GITEA_CUSTOM/public` cache if you use a CDN. + +## Configuration Tips + +- No configuration changes are required, but you can force the refreshed styles to load by setting `ui.use_service_worker = false` if you rely on aggressive caching. +- To adjust colors or typography, edit the ` + + diff --git a/custom/templates/custom/footer.tmpl b/custom/templates/custom/footer.tmpl new file mode 100644 index 0000000..fe13222 --- /dev/null +++ b/custom/templates/custom/footer.tmpl @@ -0,0 +1,33 @@ + diff --git a/custom/templates/custom/header.tmpl b/custom/templates/custom/header.tmpl new file mode 100644 index 0000000..6548064 --- /dev/null +++ b/custom/templates/custom/header.tmpl @@ -0,0 +1,1014 @@ + + + + + + + diff --git a/custom/templates/home.tmpl b/custom/templates/home.tmpl new file mode 100644 index 0000000..75aae5c --- /dev/null +++ b/custom/templates/home.tmpl @@ -0,0 +1,157 @@ +{{template "base/head" .}} +
+ {{if .IsSigned}} +
+
+
+
+ Welcome back +

Dashboard · {{.SignedUser.Name}}

+

Quick links to jump straight into your day with {{AppName}}.

+ +
+
+
+ +
+
+
+
+
+
+
+
+
+
+
+

Stay updated

+

Jump into your activity feed to review pull requests, issues and events.

+ Open dashboard +
+
+
+
+
+
+

Manage repositories

+

Keep tabs on projects, branches and pull requests that matter most.

+ View repositories +
+
+
+
+
+
+

Tune your settings

+

Update SSH keys, notifications and integrations for your workflow.

+ Open settings +
+
+
+
+
+
+ {{else}} +
+ +
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + +
+
+
+
+
+
+ +
+
+
+

Build, collaborate and deliver with confidence.

+

Lightweight, powerful and totally yours. {{AppName}} gives your team a beautiful code collaboration hub backed by open source freedom.

+ +
+
+
+
+
+
+
+
+
+

Ship faster

+

Built-in CI runners and packages help your team move ideas to production faster with less friction.

+
+
+
+

Stay secure

+

Enforce branch protections, SSO, fine-grained permissions and audit logs to keep your codebase safe.

+
+
+
+

Integrate everywhere

+

Connect with runners, chatops and automation platforms using webhooks, OAuth and a RESTful API.

+
+
+
+
+
+
+ +
+
+ {{end}} +
+{{template "base/footer" .}} diff --git a/preview-guest.html b/preview-guest.html new file mode 100644 index 0000000..2dbe183 --- /dev/null +++ b/preview-guest.html @@ -0,0 +1,839 @@ + + + + + + + Gitea - Home (Guest View) + + + + + + + + + + + + + + + +
+ +
+ +
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + +
+
+
+
+
+
+
+
+
+

Build, collaborate and deliver with confidence.

+

Lightweight, powerful and totally yours. Gitea gives your team a beautiful + code collaboration hub backed by open source freedom.

+ +
+
+
+
+ + +
+
+
+
+
+

Ship faster

+

Built-in CI runners and packages help your team move ideas to production + faster with less friction.

+
+
+
+

Stay secure

+

Enforce branch protections, SSO, fine-grained permissions and audit logs + to keep your codebase safe.

+
+
+
+

Integrate everywhere

+

Connect with runners, chatops and automation platforms using webhooks, + OAuth and a RESTful API.

+
+
+
+
+ + +
+
+ +
+
+
+ + + + + + + + \ No newline at end of file diff --git a/preview-signed-in.html b/preview-signed-in.html new file mode 100644 index 0000000..9ec69c6 --- /dev/null +++ b/preview-signed-in.html @@ -0,0 +1,712 @@ + + + + + + + Gitea - Dashboard (Signed-In View) + + + + + + + + + + + + +
+ +
+ + + + + +
+ +
+
+
+
+ Welcome back +

Dashboard · YourUsername

+

Quick links to jump straight into your day with Gitea.

+ +
+
+
+ +
+
+
+
+
+ + +
+
+
+
+
+
+

Stay updated

+

Jump into your activity feed to review pull requests, issues + and events.

+ Open dashboard +
+
+
+
+
+
+

Manage repositories +

+

Keep tabs on projects, branches and pull requests that matter + most.

+ View repositories +
+
+
+
+
+
+

Tune + your settings

+

Update SSH keys, notifications and integrations for your + workflow.

+ Open settings +
+
+
+
+
+
+ + +
+ +
+
+ + + + + + + + \ No newline at end of file