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 -------------------------------------------------- README.md | 103 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 103 insertions(+), 84 deletions(-) delete mode 100644 README create mode 100644 README.md 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. diff --git a/README.md b/README.md new file mode 100644 index 0000000..d53b36b --- /dev/null +++ b/README.md @@ -0,0 +1,103 @@ +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](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork) 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