|
1 |
| -# apache-fancy-index |
| 1 | +# apache-fancy-pages |
2 | 2 |
|
3 |
| -> Modern drop in replacement for default Apache index page. |
| 3 | +> Modern drop in replacement for default Apache index/error pages. |
4 | 4 |
|
5 | 5 | ```
|
6 |
| - ___ ___ _ |
7 |
| - | __|_ _ _ _ __ _ _|_ _|_ _ __| |_____ __ |
8 |
| - | _/ _` | ' \/ _| || || || ' \/ _` / -_) \ / |
9 |
| - |_|\__,_|_||_\__|\_, |___|_||_\__,_\___/_\_\ |
10 |
| - |__/ |
| 6 | + ___ ___ |
| 7 | + | __|_ _ _ _ __ _ _| _ \__ _ __ _ ___ ___ |
| 8 | + | _/ _` | ' \/ _| || | _/ _` / _` / -_|_-< |
| 9 | + |_|\__,_|_||_\__|\_, |_| \__,_\__, \___/__/ |
| 10 | + |__/ |___/ |
11 | 11 |
|
12 | 12 | ```
|
13 | 13 |
|
14 | 14 | 
|
| 15 | + |
15 | 16 |
|
16 | 17 |
|
17 | 18 | ## Features
|
18 | 19 | - Responsive design
|
19 | 20 | - Breadcrumb navigation
|
20 | 21 | - Search/Filter results
|
21 |
| -- Light/Dark theme based on user prefered color scheme |
| 22 | +- Light/Dark theme based on user prefered color scheme |
| 23 | +- Replacement for default error pages: 401, 403, 404, 500 |
22 | 24 |
|
23 | 25 | ## Requirements
|
24 | 26 | - Apache >= 2.4
|
|
34 | 36 |
|
35 | 37 | ```.language-bash
|
36 | 38 | apt-get update
|
37 |
| - apt-get install apache-fancy-index |
| 39 | + apt-get install apache-fancy-pages |
38 | 40 | ```
|
39 | 41 |
|
40 | 42 | Alternatively, you can download the latest `.deb` package from release tags and install it using `dpkg -i`:
|
41 | 43 |
|
42 | 44 | - Enable fancy-index conf:
|
43 | 45 |
|
44 |
| - The `fancy-index.conf` contains an alias for url `/fancy-index` to serve template, style, script and icons files. Enable this conf to set *apache-fancy-index* enabled everywhere `Options Indexes` is enabled. |
| 46 | + The `fancy-index.conf` contains an alias for url `/fancy-pages` to serve template, style, script and icons files. Enable this conf to set *fancy-index* enabled everywhere `Options Indexes` is enabled. |
45 | 47 |
|
46 | 48 | ```
|
47 | 49 | a2enconf fancy-index
|
|
51 | 53 | Voila!
|
52 | 54 |
|
53 | 55 |
|
54 |
| -### Other distros/manual install |
| 56 | +- Setup fancy-index tests: |
| 57 | + |
| 58 | + You can enable the `fancy-index-tests` conf to test index with fake content. The `tests` directory contain empty files with various extensions. |
55 | 59 |
|
56 |
| -1. Clone this repo on github (could be ***not*** up to date with the latest build). |
| 60 | + ``` |
| 61 | + a2enconf fancy-index-tests |
| 62 | + systemctl reload apache2 |
| 63 | + ``` |
57 | 64 |
|
58 |
| -2. Copy content of the folder `/assets/` to `/usr/share/apache-fancy-index`. Adjust permissions to be readable by web server. |
| 65 | + `Tests` directory is then available to the following url: `EXAMPLE.COM/fancy-index-tests/`. |
59 | 66 |
|
60 |
| -3. Copy the files in `/conf/` to apache conf available directory (debian `/etc/apache2/conf-available`) |
61 | 67 |
|
62 |
| -4. Enable conf and restart Apache. |
| 68 | +- Enable fancy-error conf: |
63 | 69 |
|
| 70 | + The `fancy-error.conf` contains an alias for url `/fancy-error` to serve templates on error and prevent them to be directly requested. |
| 71 | + |
| 72 | + ``` |
| 73 | + a2enconf fancy-error |
| 74 | + systemctl reload apache2 |
| 75 | + ``` |
64 | 76 |
|
| 77 | + Voila! |
65 | 78 |
|
66 |
| -## Setup tests directory |
67 | 79 |
|
68 |
| -You can enable the `fancy-index-tests` conf to test index with fake content. The `tests` directory contain empty files with various extensions. |
| 80 | +### Other distros/manual install |
| 81 | +
|
| 82 | +1. Clone this repo on github (could be ***not*** up to date with the latest build). |
| 83 | +
|
| 84 | +2. Copy content of the folder `/assets/` to `/usr/share/apache-fancy-pages`. Adjust permissions to be readable by web server. |
| 85 | +
|
| 86 | +3. Copy the files in `/conf/` to apache conf available directory (in debian `/etc/apache2/conf-available`) |
| 87 | +
|
| 88 | +4. Enable conf and restart Apache. |
69 | 89 |
|
70 |
| -``` |
71 |
| -a2enconf fancy-index-tests |
72 |
| -systemctl reload apache2 |
73 |
| -``` |
74 | 90 |
|
75 |
| -`Tests` directory is then available to the following url: `EXAMPLE.COM/fancy-index-tests/`. |
|
0 commit comments