https://github.com/cdvel/tequendama
My personal site ghost theme
https://github.com/cdvel/tequendama
ghost-theme
Last synced: 3 months ago
JSON representation
My personal site ghost theme
- Host: GitHub
- URL: https://github.com/cdvel/tequendama
- Owner: cdvel
- License: apache-2.0
- Created: 2020-03-17T05:15:08.000Z (about 6 years ago)
- Default Branch: src-pages
- Last Pushed: 2025-05-19T14:49:46.000Z (about 1 year ago)
- Last Synced: 2025-10-26T18:42:09.922Z (7 months ago)
- Topics: ghost-theme
- Language: SCSS
- Homepage:
- Size: 2.44 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tequendama Theme for Ghost
---
A Ghost theme for my personal blog
## Development
### Compile this theme manually
```bash
sass -t compressed assets/css/styles.scss assets/css/styles.css
```
### Workflow Overview
This theme uses GitHub Actions to:
1. Compile SCSS files to CSS
2. Deploy changes to a staging branch (`pr-pages`)
3. Automatically deploy to the production server
## Installation & Migration
### Manual Installation
Follow this guide: [Installing Ghost 1.0 without Ghost CLI](https://nehalist.io/installing-ghost-1-0-without-ghost-cli/)
### Migration Steps
For migrating to Ghost 1.0.0, follow: [Migration Guide](https://docs.ghost.org/docs/migrating-to-ghost-1-0-0#section-4-copy-your-images)
### Theme Updates
Validated for 4.X using [GScan](https://gscan.ghost.org/)
## Repository Structure
- `src-pages`: Source branch containing SCSS files
- `pr-pages`: Automated build branch with compiled CSS
- `assets/css`: Contains both source SCSS and compiled CSS files
- `partials`: Theme template partials
- `static`: Static theme assets
## Deployment
Changes to the `src-pages` branch automatically trigger the build and deployment workflow.
### Manual Deployment
If you need to deploy manually, follow the workflow steps in the GitHub Actions file.
## Manual Update to Latest Ghost
Run these commands from your home directory:
```bash
# Download and extract latest Ghost version
curl -LOk https://ghost.org/zip/ghost-latest.zip
unzip ghost-latest.zip -d ghost-temp
# Remove old files
sudo rm -rf /opt/ghost/core
sudo rm /opt/ghost/index.js
sudo rm /opt/ghost/*.json
sudo rm /opt/ghost/*.md
# Copy new files
sudo cp -R ~/ghost-temp/core /opt/ghost/
sudo cp -R ~/ghost-temp/index.js /opt/ghost/
sudo cp -R ~/ghost-temp/package.json /opt/ghost/
sudo cp -R ~/ghost-temp/npm-shrinkwrap.json /opt/ghost/
sudo cp -R ~/ghost-temp/*.md /opt/ghost/
sudo chown -R ghost:ghost /opt/ghost
# Install dependencies and set permissions
sudo npm install --production
sudo chown -R ghost:ghost /opt/ghost
# Restart service
service nginx restart
```
## Troubleshooting
If `npm install` fails, try upgrading npm:
```bash
sudo npm install -g npm
```
### Common Issues
- If CSS changes aren't visible, check if the workflow completed successfully
- For deployment issues, verify SSH credentials and server configuration