pgrouting / website

Repository to deploy pgRouting website using Sphinx/ReST

pgRouting - Website

This readme describes how to setup the pgRouting website on Debian/Ubuntu server.

Installation

• Install Sphinx/ReST

sudo apt-get install python-sphinx texlive-latex-base

• Checkout source code from Git repository

git clone git://github.com/pgRouting/website.git website

• Build website in HTML

cd website
make html

• Upload the website to gh-pages branch

git checkout gh-pages
cp -r _build/html/* .
git add <new pages>
git commit -a -m "<commit message>"
git push origin gh-pages

License

Copyright(c) pgRouting Contributors

This documentation is licensed under a Creative Commons Attribution-Share Alike 3.0 License

website's Issues

Tools/ osm2po - tool to convert OSM data into a routable format

Is the information outdated?
http://osm2po.de/
(into http://pgrouting.org/docs/tools.html )

Add RFC "Longest path problem algorithm"

Write a RFC document to describe which steps are required to implement "Longest path problem algorithm" http://en.wikipedia.org/wiki/Longest_path_problem

RFC &PSC

Names are obsolete:
rfc-01 talks about PSC
https://github.com/pgRouting/website/blob/gh-pages/rfc/rfc-01.html#L279

Add RFC "Clustering algorithm"

Write a RFC document to describe which steps are required to implement "clustering algorithm"

Add RFC "Highway Hierarchies algorithm"

Write a RFC document to describe which steps are required to implement "Highway Hierarchies algorithm"

Add RFC "All pair shortest path algorithm"

Write a RFC document to describe which steps are required to implement "All pair shortest path algorithm"

Reorganize Sponsor page

With the next larger website update review and reorganize the sponsorship page, giving some extra credit to the long-term supporters.

Add RFC "Chinese Postman Problem algorithm"

Write a RFC document to describe which steps are required to implement "Chinese Postman Problem algorithm"

How to/ Collection of useful SQL commands/ JOIN two tables

This link
http://pgrouting.org/docs/howto/sql.html#join-two-tables
takes us to exactly the same place as the previous issue
#41

• are we keeping?

How to/ Creating Data for Routing Applications

Is the information outdated?, current? are we keeping?
http://pgrouting.org/docs/howto/topology.html

Add RFC "multi-modal routing algorithm"

Write a RFC document to describe which steps are required to implement "multi-modal routing algorithm"

How to/ show the route with Mapserver

Is the information outdated?, current? are we keeping?
http://pgrouting.org/docs/howto/mapserver.html

OSGeoLive link

in the link:
https://pgrouting.org/documentation.html#pgrouting-gallery

it reads:
OSGeo LiveDVD

and it should read
OSGeoLive

it takes you to:
https://live.osgeo.org/en/index.html

and it should take you to:
https://live.osgeo.org/en/overview/pgrouting_overview.html

workshop links

in this link:
https://pgrouting.org/documentation.html#workshops-tutorials
it reads:

• pgRouting Workshop for v2.x (English)
• pgRouting Workshop for v1.05 (Français)

the first one takes you to a general workshop site, but the second takes you to:
http://postgis.fr/chrome/site/docs/workshop-routing-foss4g/docs/_build/html/index.html
and that link sould be in the workshop site

Add sitemap page and create a link on the footer

If possible create a page with a sitemap of index.
So far this doesn't seem to work automatically with "toctree".

pgRouting Gallery/ Examples and Demos/ ridethecity

pgRouting Gallery -> Examples and Demos (http://pgrouting.org/gallery.html)

find the safest bike route...
--> https://www.ridethecity.com/

• Is the information outdated?, current? are we keeping?

Tools/ osm2pgrouting - Import OSM data into pgRouting Database

Is the information outdated?
https://github.com/pgrouting/osm2pgrouting
(into http://pgrouting.org/docs/tools.html )

How to / Build pgRouting for Windows

Is the information outdated?, current? are we keeping?
https://pgrouting.org/docs/howto/build_on_windows.html

pgRouting home page still says 2.0

Originally posted here:
pgRouting/pgrouting#459

Closing that one, in favor of opening this one

How to contribute page

Fill "how to contribute" page with content

osm2pgrouting help page is out of date

http://pgrouting.org/docs/tools/osm2pgrouting.html

It doesn't show new features and shows old commandline syntax. I think all for example now require -- like --host, --user (instead of -host , -user).

Missing schema and some other stuff.

Downloads dont include from version 2.3

in this link:

• https://pgrouting.org/download.html

there is this link:

• https://launchpad.net/~georepublic/+archive/ubuntu/pgrouting-unstable

the available versions for downloads are 2.1.0 and 2.2.3

style

the style is not like the documentation http://docs.pgrouting.org/

Add RFC "Prepare pgRouting for PostGIS integration"

Write a RFC document to describe which steps are required to integrate pgRouting into PostGIS.

links inside How to/Contribute (as a table of contents)

Code Snippets
http://pgrouting.org/docs/howto/contribute.html#code-snippets
Get Involved
http://pgrouting.org/docs/howto/contribute.html#get-involved
Fork pgRouting on Github
http://pgrouting.org/docs/howto/contribute.html#fork-pgrouting-on-github

all this links returns to "how to/ contribute" (there is already a table of contents inside)
http://pgrouting.org/docs/howto/contribute.html

• are we keeping?

How to/ Network data validation

Is the information outdated?, current? are we keeping?
http://pgrouting.org/docs/howto/validation.html

How to/ Working with Shapefiles

Is the information outdated?, current? are we keeping?
http://pgrouting.org/docs/howto/shapefiles.html

How to/ Contribute

*it might be outdated? are we keeping?
http://pgrouting.org/docs/howto/contribute.html

Cleanup Howto's and Tools

The Howto's and Tools pages look very old and are probably (partially) outdated.
Maybe better to remove this section completely and use the Github Wiki or Workshop instead.

How to/ handle one-way streets

Is the information outdated?, current? are we keeping?
http://pgrouting.org/docs/howto/oneway.html

links inside How to/ Creating Data for Routing Applications (as a table of contents)

Graphs, Directed, unDirected, Reverse Costs http://pgrouting.org/docs/howto/topology.html#graphs-directed-undirected-reverse-costs
pgRouting http://pgrouting.org/docs/howto/topology.html#pgrouting
PostGIS http://pgrouting.org/docs/howto/topology.html#postgis
ArcInfo http://pgrouting.org/docs/howto/topology.html#arcinfo
GRASS http://pgrouting.org/docs/howto/topology.html#grass

all this links returns to "how to/ Creating Data for Routing Applications" (there is already a table of contents inside) http://pgrouting.org/docs/howto/topology.html -

• are we keeping?

Download page is missing openSUSE rpms

in http://pgrouting.org/download.html
the location for openSUSE rpms could be added with this uri

http://download.opensuse.org/repositories/Application:/Geo/

People then choose to add their matching openSUSE (or SLE) version.

Also we offer another way to find the package by searching on http://software.opensuse.org

If you agree, I could certainly manage to create a patch for the page.

dead link

in this link:
https://pgrouting.org/download.html

there is this link (that takes you nowhere):
https://admin.fedoraproject.org/pkgdb/acls/name/pgRouting

How to/ Working with OpenStreetMap data

Is the information outdated?, current? are we keeping?
http://pgrouting.org/docs/howto/osmdata.html

Add RFC "k-shortest path algorithm"

Write a RFC document to describe which steps are required to implement k-shortest path algorithm"

Tools/ osm4routing - OpenStreetMap data parser to turn them into a nodes-edges adapted for routing applications

Is the information outdated?
https://github.com/Tristramg/osm4routing
(into http://pgrouting.org/docs/tools.html )

Tools/ osm2postgis - Import OSM data to PostGIS

Is the information outdated?
http://osm2postgis.sourceforge.net/
(into http://pgrouting.org/docs/tools.html )

documentation links

in the website it shows:

• pgRouting versions 2.x (current)
• pgRouting versions 1.x (deprecated)

the correct documentation link for all versions is:

• http://docs.pgrouting.org/

the documentation of 1.x looks like the website, it doesn't look like in the documentation

Add Paypal donation

Add button for Paypal donations

Add RFC "Contraction Hierarchies algorithm"

Write a RFC document to describe which steps are required to implement "Contraction Hierarchies algorithm"

Add RFC "bi-directional shortest path algorithm"

Write a RFC document to describe which steps are required to implement "bi-directional shortest path algorithm"

links inside How to/Diagnostic tools (as a table of contents)

1. View just the streets in the routing database
   http://pgrouting.org/docs/howto/diagnostic_tools.html#view-just-the-streets-in-the-routing-database
2. View intersections and detect deadends
   http://pgrouting.org/docs/howto/diagnostic_tools.html#view-intersections-and-detect-deadends

all this links returns to "how to/ diagnostic tools" (there is already a table of contents inside) - .
http://pgrouting.org/docs/howto/diagnostic_tools.html

• are we keeping?

How to/ Diagnostic Tools

Is the information outdated?, current? are we keeping?

• http://pgrouting.org/docs/howto/diagnostic_tools.html

dead japanese link

in this link:
https://pgrouting.org/download.html

there are this dead link in japanese (in [2007/10/15] pgRouting-1.0_win32.zip ):
http://files.postlbs.org/pgrouting/binaries/pgRouting-1.0_win32.zip

documentation of 1.x

in this page:
https://pgrouting.org/documentation.html

it reads:
pgRouting versions 1.x (deprecated)

and takes you to:
https://pgrouting.org/docs/1.x/index.html
that is on the website.

The documentation of 1.x is in
http://docs.pgrouting.org/1.x/en/index.html

How to/ Collection of useful SQL commands

Is the information outdated?, current? are we keeping?
http://pgrouting.org/docs/howto/sql.html

How to/ Converting OSM-Files into PostgreSQL-Scripts

Is the information outdated?, current? are we keeping?

• http://pgrouting.org/docs/howto/convert_osm.html

Add RFC "Topology/network validation"

Write a RFC document to describe which steps are required to implement "Topology/network validation" to check networks for possible errors and inconsistencies.

pgRouting Gallery/ Examples and Demos/ sushi-kiwami

pgRouting Gallery -> Examples and Demos (http://pgrouting.org/gallery.html)

the closest Sushi restaurant in Niigata...
--> http://www.sushi-kiwami.com/map/

Is the information outdated?, current? are we keeping?

pgRouting Gallery/ Examples and Demos/ sushi-kiwami

pgRouting Gallery -> Examples and Demos (http://pgrouting.org/gallery.html)

the closest Sushi restaurant in Niigata...
--> http://www.sushi-kiwami.com/map/

Is the information outdated?, current? are we keeping?