diff options
author | Daniel Friesel <derf@finalrewind.org> | 2019-11-17 21:23:26 +0100 |
---|---|---|
committer | Daniel Friesel <derf@finalrewind.org> | 2019-11-17 21:23:26 +0100 |
commit | a066b340cc62d9ada95bbdf47f0d06c38c48859f (patch) | |
tree | ca2e28478e3a41fa2a45b1a77998113fbb30b9c7 /README | |
parent | 514d4e25c28c2abf293dadb434a3cdabfbfee91a (diff) |
convert readme to markdown
Diffstat (limited to 'README')
-rw-r--r-- | README | 84 |
1 files changed, 0 insertions, 84 deletions
@@ -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. |