README.adoc 3.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. // SPDX-FileCopyrightText: Adam Evyčędo
  2. //
  3. // SPDX-License-Identifier: AGPL-3.0-or-later
  4. = szczanieckiej
  5. Adam Evyčędo <me@apiote.xyz>
  6. v0.4 2024-05-16
  7. :toc:
  8. szczanieckiej is a https://git.apiote.xyz/traffic.git[TRAFFIC] server that is a part of bimba.
  9. == Name
  10. szczanieckiej is pronounced [ʂt͡ʂa'ɲɛt͡s.kjɛj], somwhat like shtcha-NYE-tskyey.
  11. It’s a name of a tram terminus in Poznań that no longer exists and which was located on Szczanieckiej street.
  12. The terminus was opened in 1925 as part of preparations for Polish General Exhibition—the biggest expo that has existed in Poland to this day, which was organised in 1929 to commemorate 10 years of Polish independence.
  13. == Building
  14. To build current version, one needs:
  15. * TRAFFIC repo in `../traffic/`
  16. * `awk`
  17. * `bare-gen` from https://git.sr.ht/~sircmpwn/go-bare
  18. * `mk`
  19. Then, all You have to do is run `mk`
  20. == Running
  21. ----
  22. ./szczanieckiej [-c configPath] command:
  23. -c string
  24. configPath (default "/etc/szczanieckiej.toml")
  25. command
  26. one of (serve|convert)
  27. ----
  28. == Configuration
  29. The exmaple config file, showing defaults for `feeds_path` and `listen_address`, is:
  30. ```
  31. feeds_path = "/var/lib/szczanieckiej"
  32. listen_address = ":51354"
  33. enabled_feeds = [ "poznan_ztm" ]
  34. ```
  35. == Contribute
  36. This project uses The Code of Merit, which is available as CODE_OF_CONDUCT file.
  37. The roadmap is available in `CHANGELOG.adoc` file and—although it’s not set in stone—feature requests are highly discouraged. Contributions, however, are welcome as patches; please send them to `szczanieckiej@git.apiote.xyz` using `git send-email`. Patches must include a sign-off to certify agreement to https://developercertificate.org/[Developer Certificate of Origin].
  38. All communication—questions, bugs, etc.—should go through the mailing list available at `szczanieckiej@git.apiote.xyz`. Note that all communication will be made public at https://asgard.apiote.xyz/.
  39. This project can be translated using Weblate at https://hosted.weblate.org/projects/bimba/
  40. To add another public transport network, follow instructions in `traffic/feed_example.go`
  41. == Mirrors
  42. The canonical repository for this project is https://git.apiote.xyz/szczanieckiej.git it’s mirrored at https://notabug.org/apiote/szczanieckiej
  43. Mirrors exist solely for the sake of the code and any additional functions provided by third-party services (including but not limited to issues and pull requests) will not be used and will be ignored.
  44. == License
  45. ----
  46. szczanieckiej Copyright (C) Adam Evyčędo
  47. This program is free software: you can redistribute it and/or modify
  48. it under the terms of the GNU Affero General Public License as published by
  49. the Free Software Foundation, either version 3 of the License, or
  50. (at your option) any later version.
  51. This program is distributed in the hope that it will be useful,
  52. but WITHOUT ANY WARRANTY; without even the implied warranty of
  53. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  54. GNU Affero General Public License for more details.
  55. You should have received a copy of the GNU Affero General Public License
  56. along with this program. If not, see <https://www.gnu.org/licenses/>.
  57. ----