GogsThemes/README.md
2020-04-17 23:30:11 +03:00

3.6 KiB

Welcome to GogsThemes!

This repo contains styles/themes for well known self hosted git service Gogs. If you find something not displayed good , feel free to contribute to make it together even better!!

Steps to activate a theme:

$GOGS_ROOT = your gogs root install location

Velvet

  • cd $GOGS_ROOT
  • git clone https://github.com/Kos-M/GogsThemes.git
  • echo '<link rel="stylesheet" href="/css/themes/velvet.css">' >> templates/inject/head.tmpl
  • mv ./GogsThemes/themes/velvet.css public/css/themes
  • rm -r ./GogsThemes

Dark

  • cd $GOGS_ROOT
  • git clone https://github.com/Kos-M/GogsThemes.git
  • echo '<link rel="stylesheet" href="/css/themes/dark_theme.css">' >> templates/inject/head.tmpl
  • mv ./GogsThemes/img/grad1.png public/img
  • mv ./GogsThemes/themes/dark_theme.css public/css/themes
  • rm -r ./GogsThemes

ScreensShots

Velvet

Dark

Bg Gradient [Dark only]

Main background was original generated with simple css rules from GradientMagic In some low end mobile devices found it enough stressful to render quickly , so i generated css to png from HtmlCssToImage

To disable a theme:

Just open $GOGS_ROOT/templates/inject/head.tmpl and delete the line contains : <link rel="stylesheet" href="/css/themes/dark_theme.css"> or (for velvet) : <link rel="stylesheet" href="/css/themes/velvet.css">

Contribute +/-

Feel free to submit any new theme , or corrections to existing ones.

Necessary tools:

  • NodeJs
  • Sass npm install -g sass

Creating new theme:

-As main theme we use Dark-

  • Fork this repo..
  • git clone https://github.com/<your userName here>/GogsThemes.git
  • cd GogsThemes/themes
  • cp dark_theme.scss new_theme_name.scss
  • sass --watch new_theme_name.scss new_theme_name.css
  • mkdir ../img/screenShots/new_theme_name
  • take screenshots like { file.png , home.png , intro.png , repo.png , signup.png } of your theme (saved under GogsThemes/img/screenShots/new_theme_name/
  • update README.md with activate instructions and screenshots for new theme.
  • commit & push to your fork
  • create a pull request.