|
1 | | -# JKAN [](https://travis-ci.org/timwis/jkan) [](https://gitter.im/timwis/jkan?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |
| 1 | +# JKAN |
2 | 2 | A lightweight, backend-free open data portal, powered by Jekyll |
3 | 3 |
|
4 | 4 | Open-source data portals can be really hard to install and maintain. But their |
5 | 5 | basic purpose of providing links to download data really isn't that complicated. JKAN is a proof-of-concept |
6 | 6 | that allows a small, resource-strapped government agency to stand-up an open data portal by simply |
7 | 7 | [clicking the fork button](https://help.github.com/articles/fork-a-repo/). |
8 | 8 |
|
9 | | -Please note this is still a work in progress! Check out the [issues](https://github.com/timwis/jkan/issues) to help |
10 | | -out or give feedback. |
11 | | - |
12 | 9 | [Demo site](https://demo.jkan.io) |
13 | 10 |
|
14 | | -## Installation Options |
15 | | - |
16 | | -1. See [Get Started](https://jkan.io/#get-started) on [jkan.io](https://jkan.io) for an installation wizard, |
17 | | -2. follow the [manual installation](https://github.com/timwis/jkan/wiki/Manual-Installation) instructions yourself. |
18 | | -3. Do a manual fork and do not install gatekeeper at all (login bits won't work, but Heroku is no longer free) |
19 | | - |
20 | | -For configuration details, see the [wiki](https://github.com/timwis/jkan/wiki) |
21 | | - |
22 | | -## Development |
23 | | -The recommended to build the site for development or making changes is docker compose. Just run ```docker compose up``` |
24 | | - |
25 | | -```bash |
26 | | -$ docker compose up |
27 | | -[+] Running 1/0 |
28 | | - ⠿ Container jkan-jekyll-1 Created 0.0s |
29 | | -Attaching to jkan-jekyll-1 |
30 | | -jkan-jekyll-1 | ruby 2.6.3p62 (2019-04-16 revision 67580) [x86_64-linux-musl] |
31 | | -jkan-jekyll-1 | Configuration file: /srv/jekyll/_config.yml |
32 | | -jkan-jekyll-1 | Source: /srv/jekyll |
33 | | -jkan-jekyll-1 | Destination: /srv/jekyll/_site |
34 | | -jkan-jekyll-1 | Incremental build: enabled |
35 | | -jkan-jekyll-1 | Generating... |
36 | | -jkan-jekyll-1 | done in 0.025 seconds. |
37 | | -jkan-jekyll-1 | Auto-regeneration: enabled for '/srv/jekyll' |
38 | | -jkan-jekyll-1 | Server address: http://0.0.0.0:4000/jkan/ |
39 | | -jkan-jekyll-1 | Server running... press ctrl-c to stop. |
40 | | -``` |
41 | | - |
42 | | -Then connect to http://0.0.0.0:4000/jkan/ via a web browser. |
43 | | - |
44 | | -Read more about the [Architecture](https://github.com/timwis/jkan/wiki/Architecture) on the Wiki. |
| 11 | +## Documentation |
| 12 | +* [Installation](docs/installation.md) |
| 13 | +* [Upgrading](docs/upgrading.md) |
| 14 | +* [Schema customization](docs/schema-customization.md) |
| 15 | +* [Running locally](docs/running-locally.md) |
| 16 | +* [Architecture](docs/architecture.md) |
0 commit comments