From a066b340cc62d9ada95bbdf47f0d06c38c48859f Mon Sep 17 00:00:00 2001 From: Daniel Friesel Date: Sun, 17 Nov 2019 21:23:26 +0100 Subject: convert readme to markdown --- README | 84 ------------------------------------------------------------------ 1 file changed, 84 deletions(-) delete mode 100644 README (limited to 'README') 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 -------------------------------------------------------------------------- - - - - -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 `` element with "name", "eva" and "ds100" attributes, you're -good to go. -- cgit v1.2.3