summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorDaniel Friesel <derf@finalrewind.org>2019-11-17 21:23:26 +0100
committerDaniel Friesel <derf@finalrewind.org>2019-11-17 21:23:26 +0100
commita066b340cc62d9ada95bbdf47f0d06c38c48859f (patch)
treeca2e28478e3a41fa2a45b1a77998113fbb30b9c7 /README
parent514d4e25c28c2abf293dadb434a3cdabfbfee91a (diff)
convert readme to markdown
Diffstat (limited to 'README')
-rw-r--r--README84
1 files changed, 0 insertions, 84 deletions
diff --git a/README b/README
deleted file mode 100644
index 1b59c04..0000000
--- a/README
+++ /dev/null
@@ -1,84 +0,0 @@
-Travel::Status::DE::IRIS - Interface to IRIS based web departure monitors
--------------------------------------------------------------------------
-
-<https://finalrewind.org/projects/Travel-Status-DE-IRIS/>
-
-
-Dependencies
-------------
-
-* perl version 5.14.2 or newer
-* Class::Accessor
-* DateTime
-* DateTime::Format::Strptime
-* Geo::Distance
-* List::Compare
-* List::MoreUtils
-* List::UtilsBy
-* LWP::UserAgent
-* Text::LevenshteinXS
-* XML::LibXML
-
-Note about Text::LevenshteinXS: This module is old and unmaintained, but
-appears to be packaged for slightly more distros than its successor
-Text::Levenshtein::XS. If it is not available for your distro (and you do
-not wish to build it), the following drop-in replacements are available:
-
-* Text::Levenshtein::XS
-* Text::Levenshtein (about 10 times slower than the XS modules)
-
-To use them, run:
-> sed -i 's/Text::LevenshteinXS/Text::Levenshtein::XS/g' Build.PL lib/Travel/Status/DE/IRIS/Stations.pm
-or
-> sed -i 's/Text::LevenshteinXS/Text::Levenshtein/g' Build.PL lib/Travel/Status/DE/IRIS/Stations.pm
-
-Installation
-------------
-
-From a release tarball:
-
-* perl Build.PL
-* ./Build
-* sudo ./Build install
-
-From git:
-
-* perl Build.PL
-* ./Build
-* ./Build manifest
-* sudo ./Build install
-
-See also the Module::Build documentation.
-
-You can then run 'man Travel::Status::DE::IRIS'.
-This distribution also ships the script 'db-iris', see 'man db-iris'.
-
-Managing stations
------------------
-
-Travel::Status::DE::IRIS needs a list of train stations to operate, which is
-located in `share/stations.json`. There are two recommended editing methods.
-
-Automatic method, e.g. to incorporate changes from Open Data sources:
-
-* modify stations.json with a script in any JSON-aware language you like
-* run ./json2json in the share diretcory. This transforms stations.json into
- its canonical format, which simplifies tracking of changes and reduces diff
- size
-
-Manual method:
-
-* run ./json2csv in the share directory
-* modify stations.csv automatically or manually (e.g. with LibreOffice Calc)
-* run ./csv2json in the share directory
-
-If the changes you made are suitable for inclusion in Travel::Status::DE::IRIS,
-please open a pull request afterwards.
-
-Please only include stations which are usable with DB IRIS, that is, which have
-both DS100 and UIC numbers. If
-`curl -s https://iris.noncd.db.de/iris-tts/timetable/station/UICNUMBER`
-and
-`curl -s https://iris.noncd.db.de/iris-tts/timetable/station/DS100`
-return a `<station>` element with "name", "eva" and "ds100" attributes, you're
-good to go.