codex-storage
/
deluge
mirror of https://github.com/codex-storage/deluge.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Deluge BitTorrent client - Git mirror, PRs only https://www.deluge-torrent.org
33 Commits 6 Branches 83 Tags 70 MiB
Python 75.6%
JavaScript 15.2%
CSS 8.3%
Shell 0.4%
NSIS 0.3%
Other 0.1%
Go to file
Calum Lind db24bdc530
Move nav script to js file 		2024-07-08 21:50:48 +01:00
deluge-torrent.org/htdocs Update nav header for new docs location 2024-07-08 10:20:50 +01:00
docs Fix mkdocs links warnings 2024-07-08 11:53:28 +01:00
forum.deluge-torrent.org/htdocs/styles/deluge_stormyday_3.3 Update nav header for new docs location 2024-07-08 10:20:50 +01:00
overrides Move nav script to js file 2024-07-08 21:50:48 +01:00
trac_wiki_export Add trac wiki export and migration scripts 2024-07-06 16:22:30 +01:00
.gitignore Use docker compose to simplify dev and build 2024-07-08 10:19:37 +01:00
Dockerfile Add Dockerfile to include extra plugins 2024-07-07 18:59:45 +01:00
README.md Fix mkdocs links warnings 2024-07-08 11:53:28 +01:00
docker-compose.yml Add user for docker to avoid root owned files 2024-07-08 21:45:05 +01:00
mkdocs.yml Fix mkdocs links warnings 2024-07-08 11:53:28 +01:00

README.md

Deluge Website

Home

The original site is served from index.php with a custom navigation header that can be applied to other web services.

Docs

Homepage and docs are generated by Mkdocs from markdown pages. These pages have been migrated from the old Trac wiki so odd syntax problems might remain and need fixed.

Local dev

docker compose up

Open browser at http://localhost:8000

Live reloading will refresh the served pages modifying mkdocs.yml and markdown pages. Changes to any overrides files requires restarting docker server.

Mkdocs Plugins

Awesome pages plugin

This pages plugin solves the issue where mkdocs only includes the specific pages listed in the config nav section which means it would be cumbersome to list every pages and it's location. To help build the navigation this plugin allows using ellipsis with filters to indicate all other pages to include in sections.

In future if all pages are listed in config nav section this plugin would be redundant.

Build site

docker compose run mkdocs build

The build output will be in site directory.

Override home and header

The overrides directory contains the files to set a custom homepage and custom header for the site.

Forum

The Deluge forum is provided by phpBB. It uses a MySQL database and is installed in the following location:

  • /var/www/forum.deluge-torrent.org/htdocs/

The Deluge navigation header is setup in a custom phpBB style theme named deluge_stormyday_3.3 based on the default prosilver theme.

Note: Changes made to live site will not be reflected until a Purge Cache action is performed from admin control panel.

CGIT

cgit is a web interface to the git repos.

  • Installation: /var/www/git.deluge-torrent.org/
  • cgit config: /etc/cgitrc
  • Apache config: /etc/httpd/sites-enabled/git.deluge-torrent.org.conf

Custom header

The cgit config links to the following files to provide the Deluge header nav bar:

  • /var/www/deluge-torrent.org/htdocs/cgit-head-include
  • /var/www/deluge-torrent.org/htdocs/deluge_header_nav.html

Other Root files

Test port

These two PHP scripts provide the application with a test port option to verify network connectivity.

  • test-port.php
  • test_port.php

Http Downloader

For unit testing purposes there is a httpdownloader.php to test downloading different types of files.