scient.ing theme for git.scient.ing
This repo is Gitea's custom folder. On the server it is cloned once and mounted into the container, so an update is git pull and a restart.
Nothing replaces a Gitea file, and removing the mount restores the defaults.
| Path in the repo | What it does |
|---|---|
public/assets/css/theme-scienting-auto.css |
follows each visitor's light or dark setting; the default |
public/assets/css/theme-scienting-light.css |
the computation pad |
public/assets/css/theme-scienting-dark.css |
the greenboard |
public/assets/fonts/scienting/ |
Atkinson Hyperlegible Next and Mono, self-hosted, with their license |
public/assets/img/ |
the dot-with-spread logo and favicons in place of Gitea's teacup |
templates/home.tmpl |
the signed-out home page, in the studio's voice |
templates/custom/extra_links_footer.tmpl |
adds a scient.ing link and the company's legal name, Scientific Computing Studio, LLC, to the footer |
The themes start from Gitea 28.1.0's own theme files and change only the brand colors, fonts, and corner radius. Gitea's named colors for status, diffs, and syntax highlighting stay as Gitea tuned them. Every text color passes WCAG AA against its background in both themes.
How it is wired
The server runs the rootless Gitea image with /opt/gitea/data mounted at /var/lib/gitea.
Gitea's custom folder is therefore /opt/gitea/data/custom on the host.
The clone lives at /opt/gitea/theme and is mounted read-only over that folder.
First-time setup
On the server, as root.
-
Back up what is in the current custom folder. The mount hides it, so nothing is lost, but keep a copy:
cp -a /opt/gitea/data/custom /opt/gitea/custom.bak -
Clone the repo:
git clone https://git.scient.ing/core/gitea-custom-theme.git /opt/gitea/themeThe files must be readable by uid 1000, which a normal clone already is.
-
Add one line under
volumes:of theserverservice in/opt/gitea/docker-compose.yml:- /opt/gitea/theme:/var/lib/gitea/custom:ro -
Merge
app.ini.scientinginto/opt/gitea/config/app.ini. It sets three things:APP_NAME = scient.ing git, which replaces "Scienting Git" in page titles. It goes at the top of the file, before any[section]. The brand writes the name lowercase, with the dot.[ui] DEFAULT_THEME = scienting-auto. Yourapp.inihas noTHEMESline, so Gitea offers every theme it finds. If you add one later, it must list the three scient.ing themes.[ui.meta], the author, description, and keywords search engines see.
[ui]already exists in your file withSHOW_USER_EMAIL; addDEFAULT_THEMEto that section instead of creating a second one. -
Recreate the container so the new mount takes effect:
cd /opt/gitea && docker compose up -d
Update
git -C /opt/gitea/theme pull
docker restart gitea
Gitea caches templates in production mode, so the restart is needed for .tmpl changes. CSS and images are read from disk, but the restart is harmless and browsers may need a hard refresh.
The container is named gitea (the compose service is server).
Check
Signed out:
- The home page shows the scient.ing wordmark and "Where we show our work."
- The navbar shows the green tile with the dot-with-spread mark.
- The theme menu in the footer lists "scient.ing auto."
Gitea stores a theme for each account when it is created, so existing accounts, including yours, keep their old theme. Switch under Settings, then Appearance. New accounts and signed-out visitors get scient.ing automatically. Hard-refresh the browser if the old logo lingers.
Optional
- To hide the Gitea version from visitors, set
SHOW_FOOTER_VERSION = falsein an[other]section. Admins still see it. Leaving "Powered by Gitea" in place credits the software the studio stands on, so this bundle keeps it. - The home page text is in English only. Edit
templates/home.tmplto change the wording; its styles use Gitea's color variables, so it also works under Gitea's own themes. - The fonts are under the SIL Open Font License 1.1 (
public/assets/fonts/scienting/OFL.txt). README-scienting-theme.mdandapp.ini.scientingsit in the custom folder too. Gitea ignores them.