Files
gitea-custom-theme/README-scienting-theme.md
T
2026-10-18 06:35:59 -04:00

3.5 KiB

scient.ing theme for git.scient.ing

Everything here goes into Gitea's custom folder ($GITEA_CUSTOM). Nothing replaces a Gitea file, and removing these files restores the defaults.

Path in the custom folder 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 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.

Find the custom folder

Sign in as an admin and open Site Administration, then Configuration. The path is listed as "Custom File Root Path." In the official Docker image it is /data/gitea. Binary installs often use /var/lib/gitea/custom.

Back up what you have

Your current home page and any logo you added live in that folder. Copy them aside first:

cp -a $GITEA_CUSTOM/templates/home.tmpl ~/home.tmpl.bak
cp -a $GITEA_CUSTOM/public/assets/img ~/gitea-img.bak

Skip a line if the file or folder does not exist.

Copy the files in

From the folder this README is in:

rsync -a --exclude README-scienting-theme.md --exclude app.ini.scienting ./ $GITEA_CUSTOM/
chown -R git:git $GITEA_CUSTOM/public $GITEA_CUSTOM/templates

Use the user and group Gitea runs as in place of git:git. In Docker, copy into the volume mounted at /data.

Edit app.ini

Merge app.ini.scienting into your app.ini. It sets three things:

  • APP_NAME = scient.ing git, which replaces "Scienting Git" in page titles. The brand writes the name lowercase, with the dot.
  • [ui] DEFAULT_THEME = scienting-auto. If your app.ini already has a THEMES line, it must list the three scient.ing themes, or Gitea hides them. Without a THEMES line, Gitea offers every theme it finds.
  • [ui.meta], the author, description, and keywords search engines see.

5. Restart Gitea and check

docker restart server

Then 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 = false in 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.tmpl to 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).