{"id":13405826,"url":"https://github.com/jmlemetayer/abba","last_synced_at":"2025-03-14T10:31:49.144Z","repository":{"id":9158253,"uuid":"51692847","full_name":"jmlemetayer/abba","owner":"jmlemetayer","description":"Apache Bootstrap \u0026 Bootswatch Autoindex","archived":false,"fork":false,"pushed_at":"2024-10-24T01:26:01.000Z","size":4442,"stargazers_count":80,"open_issues_count":5,"forks_count":6,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-10-24T16:57:16.418Z","etag":null,"topics":["abba","apache2","autoindex","bootstrap","bootswatch"],"latest_commit_sha":null,"homepage":"https://jmlemetayer.github.io/abba/previews/default/","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jmlemetayer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2016-02-14T11:58:40.000Z","updated_at":"2024-09-14T03:37:21.000Z","dependencies_parsed_at":"2023-01-16T21:15:55.820Z","dependency_job_id":"d9389924-3a91-4ef0-9a29-20d0c2186865","html_url":"https://github.com/jmlemetayer/abba","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmlemetayer%2Fabba","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmlemetayer%2Fabba/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmlemetayer%2Fabba/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmlemetayer%2Fabba/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmlemetayer","download_url":"https://codeload.github.com/jmlemetayer/abba/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243562075,"owners_count":20311213,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["abba","apache2","autoindex","bootstrap","bootswatch"],"created_at":"2024-07-30T19:02:13.024Z","updated_at":"2025-03-14T10:31:49.127Z","avatar_url":"https://github.com/jmlemetayer.png","language":"SCSS","funding_links":[],"categories":["SCSS"],"sub_categories":[],"readme":"# ![logo](abba/images/favicon.ico) ABBA\nApache Bootstrap \u0026 Bootswatch Autoindex\n\nYou find that the [autoindex][mod_autoindex] module on your\n[Apache http server][httpd] is very useful to make your files accessible online.\nBut the only drawback is that the default web interface is ugly and not suitable\nfor modern use?\n\nThen ABBA is made for you.\n\n[httpd]: http://httpd.apache.org\n[mod_autoindex]: https://httpd.apache.org/docs/2.4/mod/mod_autoindex.html\n\n## Features\n\n* Fully responsive using [Bootstrap][bootstrap]\n* Multiple themes using [Bootswatch][bootswatch]\n* Awesome icons using [FontAwesome][fontawesome]\n* Pretty date formatting using [Moment.js][momentjs]\n* File sorting \u0026 filtering\n* Custom error pages\n* [Easy network installation](#installation)\n* Local development using [docker containers](#development)\n\n## Previews\n\n### Online previews\n\nOnline previews of the ABBA themes can be found [here][previews]. You can use\nthe navigation menus to switch between available themes and pages.\n\n_Note that these previews are static pages used to get an idea of the final\nresult, so some links and features are disabled or will not work as expected._\n\n[previews]: https://jmlemetayer.github.io/abba/previews/default\n\n### Local previews\n\nLocal previews can be achieved by using the [test docker image](docker):\n\n```bash\ndocker run --rm --tty --interactive \\\n    --publish 8080:80 \\\n    --volume ${PWD}:/var/www \\\n    jmlemetayer/abba\n```\n\nThese previews allow you to test all the available themes and features locally\nwith minimal requirements.\n\n## Installation\n\n### Prerequisites\n\nThe only requirement is to have a working [Apache http server][httpd] with\nthese modules enabled: [mod_autoindex][mod_autoindex],\n[mod_include][mod_include] and [mod_mime][mod_mime].\n\n[mod_include]: https://httpd.apache.org/docs/2.4/mod/mod_include.html\n[mod_mime]: https://httpd.apache.org/docs/2.4/mod/mod_mime.html\n\nAlso ensure that the [`AllowOverride All`][allowoverride] directive is set for\nyour [`DocumentRoot`][documentroot] because ABBA uses an [`.htaccess`][htaccess]\nfile. If you do not want to allow these files, you can copy the content of the\ndistributed [`htaccess`](abba/htaccess) to your [`VirtualHost`][virtualhost].\n\n[allowoverride]: https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride\n[documentroot]: https://httpd.apache.org/docs/2.4/mod/core.html#documentroot\n[htaccess]: https://httpd.apache.org/docs/2.4/howto/htaccess.html\n[virtualhost]: https://httpd.apache.org/docs/2.4/mod/core.html#virtualhost\n\n### Step 1\n\nTo easily install ABBA from the network go into your\n[`DocumentRoot`][documentroot] directory and run this shell one-liner:\n\n``` bash\nT=$(mktemp) \u0026\u0026 curl -sL git.io/abba -o ${T} \u0026\u0026 sh ${T}\n```\n\nYou will be prompted to select the desired theme you wish to use.\n\nAnd that's it! :sunglasses:\n\n### Installed files\n\nHere is what is installed:\n\n```\n├── .abba\n│   ├── css\n│   │   └── style.css\n│   ├── html\n│   │   ├── header.shtml\n│   │   ├── footer.shtml\n│   │   └── error_*.shtml\n│   ├── js\n│   │   └── script.js\n│   ├── uninstall\n│   └── webfonts\n│       └── fa-*\n└── .htaccess\n```\n\n### Tips and tricks\n\n* An `uninstall` script is generated in the `.abba` directory.\n* If you want to automate the installation and skip the theme request you can\n  add the theme name at the end of the one-liner:\n  ``` bash\n  T=$(mktemp) \u0026\u0026 curl -sL git.io/abba -o ${T} \u0026\u0026 sh ${T} litera\n  ```\n\n## Troubleshooting\n\n* **I have a basic 404 error.**\u003cbr\u003e\n  It seems that the [mod_autoindex][mod_autoindex] is not enabled.\n* **I still have my old autoindex.**\u003cbr\u003e\n  Ensure that the [`AllowOverride All`][allowoverride] directive is set for\n  your [`DocumentRoot`][documentroot].\n* **The autoindex have changed, but it is not pretty at all.**\u003cbr\u003e\n  Check if [mod_include][mod_include] and [mod_mime][mod_mime] are enabled.\n\n## Development\n\nThe local development workflow is using two docker containers to be able to\ngenerate the distribution files and test them with in a real environment.\nEverything you need to know is described in the [`docker`](docker#development)\ndirectory.\n\n## License\nABBA has been inspired by\n[iglvzx/IGalvez.Autoindex][igalvezautoindex] _([GPLv3][igalvezautoindex-license])_.\n\nABBA is released under the [MIT License](LICENSE.md).\n\n[igalvezautoindex]: https://github.com/iglvzx/IGalvez.Autoindex\n[igalvezautoindex-license]: https://github.com/iglvzx/IGalvez.Autoindex/blob/master/LICENSE\n\n## Credits\n\n* [Bootstrap][bootstrap] _([MIT][bootstrap-license])_\n* [Bootswatch][bootswatch] _([MIT][bootswatch-license])_\n* [FontAwesome][fontawesome] _([CC BY 4.0, SIL OFL 1.1, MIT][fontawesome-license])_\n* [Jekyll Compress HTML][jekyll-compress-html] _([MIT][jekyll-compress-html-license])_\n* [JQuery][jquery] _([MIT][jquery-license])_\n* [Moment.js][momentjs] _([MIT][momentjs-license])_\n* [Popper.js][popperjs] _([MIT][popperjs-license])_\n\nIcon made by [mynamepong][flaticon-mynamepong].\n\n[bootstrap]: https://github.com/twbs/bootstrap\n[bootstrap-license]: https://github.com/twbs/bootstrap/blob/main/LICENSE\n[bootswatch]: https://github.com/thomaspark/bootswatch\n[bootswatch-license]: https://github.com/thomaspark/bootswatch/blob/v4/LICENSE\n[fontawesome]: https://github.com/FortAwesome/Font-Awesome\n[fontawesome-license]: https://github.com/FortAwesome/Font-Awesome/blob/master/LICENSE.txt\n[jquery]: https://github.com/jquery/jquery\n[jquery-license]: https://github.com/jquery/jquery/blob/master/LICENSE.txt\n[momentjs]: https://github.com/moment/moment\n[momentjs-license]: https://github.com/moment/moment/blob/develop/LICENSE\n[popperjs]: https://github.com/popperjs/popper-core\n[popperjs-license]: https://github.com/popperjs/popper-core/blob/master/LICENSE.md\n[jekyll-compress-html]: https://github.com/penibelst/jekyll-compress-html\n[jekyll-compress-html-license]: https://github.com/penibelst/jekyll-compress-html/blob/master/LICENSE\n[flaticon-mynamepong]: https://www.flaticon.com/authors/mynamepong\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmlemetayer%2Fabba","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmlemetayer%2Fabba","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmlemetayer%2Fabba/lists"}