{"id":44343461,"url":"https://github.com/openlibhums/salford","last_synced_at":"2026-02-11T13:11:17.474Z","repository":{"id":305841292,"uuid":"1024109167","full_name":"openlibhums/salford","owner":"openlibhums","description":"Sub theme for UoS","archived":false,"fork":false,"pushed_at":"2025-07-22T08:17:48.000Z","size":31,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-22T09:45:46.892Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openlibhums.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-22T07:43:38.000Z","updated_at":"2025-07-22T08:17:52.000Z","dependencies_parsed_at":"2025-07-22T09:45:48.381Z","dependency_job_id":null,"html_url":"https://github.com/openlibhums/salford","commit_stats":null,"previous_names":["openlibhums/salford"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/openlibhums/salford","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openlibhums%2Fsalford","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openlibhums%2Fsalford/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openlibhums%2Fsalford/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openlibhums%2Fsalford/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openlibhums","download_url":"https://codeload.github.com/openlibhums/salford/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openlibhums%2Fsalford/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29333170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T12:42:24.625Z","status":"ssl_error","status_checked_at":"2026-02-11T12:41:23.344Z","response_time":97,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-11T13:11:16.667Z","updated_at":"2026-02-11T13:11:17.459Z","avatar_url":"https://github.com/openlibhums.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Salford Theme\n\nA custom theme for Janeway based on the University of Salford's branding and design guidelines. This is a subtheme of https://github.com/openlibhums/janeway/tree/master/src/themes/OLH.\n\nRename the theme folder to 'salford'. This theme is to be used on https://openjournals.salford.ac.uk/.\n\nFor more information on Janeway see https://janeway.readthedocs.io/en/v1.7.2/dev/configuration.html#django-settings\n\n## Features\n\n- Salford University fonts (ReplicaPro family)\n- Custom color scheme matching Salford branding\n- Responsive design\n- Custom styling for headers, navigation, and footer\n\n## Build Process\n\nThe theme uses a unified build script that supports different modes:\n\n### Quick Copy (Default)\n```bash\ncd src\npython3 themes/salford/build_assets.py copy\n```\nCopies CSS and all assets from `themes/salford/assets/` to `static/salford/`.\n\n### Watch Mode (Development)\n```bash\ncd src\npython3 themes/salford/build_assets.py watch\n```\nWatches for changes in CSS files and automatically copies them to the static directory. Perfect for development!\n\n### Full Build (Production)\n```bash\ncd src\npython3 themes/salford/build_assets.py build\n```\nPerforms a complete build including:\n- Copying all assets\n- Processing SCSS (if available)\n- Processing JavaScript\n- Handling journal overrides\n- Running Django's collectstatic\n\n### Help\n```bash\ncd src\npython3 themes/salford/build_assets.py help\n```\nShows usage information and available modes.\n\n## File Structure\n\n```\nthemes/salford/\n├── assets/\n│   ├── css/\n│   │   └── salford.css          # Main CSS file\n│   ├── js/                      # JavaScript files (if any)\n│   ├── fonts/                   # Font files (if any)\n│   └── img/                     # Images (if any)\n├── templates/\n│   └── core/\n│       └── base.html            # Base template\n├── build_assets.py              # Unified build script\n└── README.md                    # This file\n```\n\n## Development Workflow\n\n1. **Edit CSS**: Modify `themes/salford/assets/css/salford.css`\n2. **Copy Changes**: Run `python3 themes/salford/build_assets.py copy`\n3. **View Changes**: Refresh your browser to see updates\n\n**Note**: View the local site at http://localhost:4444/\n\n## Local Development Setup\n\nThe site is configured to run on http://localhost:4444/ through the following changes:\n\n### Docker Configuration\n- **Port Mapping**: The `docker-compose.yml` file maps port 4444 on the host to port 8000 in the container:\n  ```yaml\n  ports:\n    - \"4444:8000\"\n  ```\n\n### Domain Configuration\nTo ensure the site works correctly with localhost:4444, run one of these commands:\n\n**Option 1**: Use the Django management command:\n```bash\ncd src\npython3 manage.py update_domains\n```\n\n**Option 2**: Use the standalone script:\n```bash\npython3 update_domains.py\n```\n\n**Option 3**: Use the fix domains command (only updates journals with empty domains):\n```bash\ncd src\npython3 manage.py fix_domains\n```\n\nThese commands update the Press and Journal domain configurations in the database to use `localhost:4444`.\n\nFor **automatic updates during development**:\n```bash\npython3 themes/salford/build_assets.py watch\n```\n\n## Theme Activation\n\nTo activate this theme for a journal:\n\n1. Go to the journal's admin panel\n2. Navigate to **Manager \u003e Journal Settings \u003e General**\n3. Set \"Journal Theme\" to \"salford\"\n4. Save the settings\n\n## Dependencies\n\nThe build script handles missing dependencies gracefully:\n- **Django**: Required for full build features\n- **Sass**: Optional for SCSS processing\n- **jsmin**: Optional for JavaScript minification\n\nIf dependencies are missing, the script will skip those features and continue with available functionality.\n\n## Git Usage\n\nThis theme is now properly configured for git version control. The theme files are tracked by git and you can:\n\n### Check Status\n```bash\ngit status src/themes/salford/\n```\n\n### Add Changes\n```bash\ngit add src/themes/salford/\n```\n\n### Commit Changes\n```bash\ngit commit -m \"Update salford theme: [description of changes]\"\n```\n\n### View History\n```bash\ngit log --oneline src/themes/salford/\n```\n\n### Ignored Files\nThe local `.gitignore` file in this directory ignores:\n- Python cache files (`__pycache__/`, `*.pyc`)\n- Build artifacts and temporary files\n- IDE-specific files\n- Environment files\n\nThis ensures that only the source files are tracked while build artifacts and temporary files are excluded.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenlibhums%2Fsalford","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenlibhums%2Fsalford","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenlibhums%2Fsalford/lists"}