115 lines
3.3 KiB
Markdown
115 lines
3.3 KiB
Markdown
# Gridspinoza theme
|
|
|
|
Theme based up on BootStrap modified for the [GridSpinoza](https://gridspinoza.net) website, as part of the [Hangar](https://hangar.org)network.
|
|
|
|
|
|
## Development / modifications
|
|
|
|
The repo is cloned inside the servers theme, but from ther we have no writing permissions in the git repository, so the development is always done locally, then pushed to [Hangar Git](http://git.hangar.org) and from the server they are `pulled`.
|
|
|
|
In our computer (localhost):
|
|
```
|
|
git clone ssh://git@git.hangar.org:21036/hangar-tech/gridspinoza.git
|
|
```
|
|
|
|
|
|
## Appliying changes in server
|
|
|
|
Before we did prepare the content by https cloning the repo `git clone https://git.hangar.org/hangar-tech/gridspinoza.git` and changing file permissions to server needs.
|
|
|
|
Go to the theme directory:
|
|
```
|
|
cd /var/www/html/sites/all/themes/gridspinoza
|
|
```
|
|
|
|
|
|
from there checkout the `main` branch and `pull`
|
|
```
|
|
git checkout main
|
|
git pull
|
|
```
|
|
|
|
### checking changes before apply
|
|
We can create different branches locally, then push them and in the server preview before applying to main.
|
|
|
|
For example, need to fix "font-size" some were.
|
|
|
|
#### local host
|
|
|
|
checkout main repo and be up to date
|
|
|
|
```
|
|
git checkout main
|
|
git status
|
|
git pull
|
|
```
|
|
create new branch and check out
|
|
```
|
|
git branch fix/font-size
|
|
git checkout fix/font-size
|
|
```
|
|
start doing changes and commit and push them to server
|
|
|
|
#### in the sever
|
|
Pull changes
|
|
|
|
```
|
|
cd /var/www/html/sites/all/themes/gridspinoza
|
|
git fetch --all
|
|
git checkout fix/font-size
|
|
git pull
|
|
```
|
|
now you can refresh the browser and eventually fix more things.
|
|
|
|
if you like it then do as next:
|
|
|
|
sever: `git checkout main`
|
|
|
|
localhost:
|
|
- `git fetch all` to get all changes
|
|
- in the _fix/font-size_ branch do `git merge main`
|
|
- if ok, then go to _main_ branch `git checkout main`
|
|
- merge changes `git merge fix/font-size`
|
|
- publish the changes `git push`
|
|
|
|
go to the server, inside the theme directory `git fetch --all` and then `git checkout main` and finally `git pull`
|
|
|
|
|
|
## Drupal enable debug mode
|
|
This way we can check the html source code and see where the files are generated.
|
|
|
|
edit `/var/www/html/sites/default/services.yml` set option `debug: true` and go into drupal admin *configuration* -> *development* -> *performance* and **clear all caches**
|
|
the url is https://MYWEBSITE.COM/admin/config/development/performance
|
|
|
|
---
|
|
|
|
<!-- @file Instructions on how to sub-theme the Drupal Bootstrap base theme using the CDN Starterkit. -->
|
|
<!-- @defgroup subtheme_cdn -->
|
|
<!-- @ingroup subtheme -->
|
|
# CDN Starterkit
|
|
|
|
The CDN Starterkit is rather simple to set up. You don't have to do anything
|
|
until you wish to override the default [Drupal Bootstrap] base theme settings
|
|
or provide additional custom CSS.
|
|
|
|
- [Prerequisite](#prerequisite)
|
|
- [Override Styles](#styles)
|
|
- [Override Settings](#settings)
|
|
- [Override Templates and Theme Functions](#registry)
|
|
|
|
## Prerequisite
|
|
Read the @link subtheme Sub-theming @endlink parent topic.
|
|
|
|
## Override Styles {#styles}
|
|
Open `./subtheme/css/style.css` and modify the file to your liking.
|
|
|
|
## Override Settings {#settings}
|
|
Please refer to the @link subtheme_settings Sub-theme Settings @endlink topic.
|
|
|
|
## Override Templates and Theme Functions {#registry}
|
|
Please refer to the @link registry Theme Registry @endlink topic.
|
|
|
|
[Drupal Bootstrap]: https://www.drupal.org/project/bootstrap
|
|
[Bootstrap Framework]: http://getbootstrap.com
|
|
[jsDelivr CDN]: http://www.jsdelivr.com
|