<div dir="ltr">This is my own memo how to build pgRouting with documentation, and how to publish it to GH-Pages and Transifex:<div><a href="https://gist.github.com/dkastl/5617030">https://gist.github.com/dkastl/5617030</a><br></div><div><br></div><div>Vicky did the documentation updates in the past months, so I'm not sure all dependencies and commands are still 100% the same with newer versions of Ubuntu for example.</div><div>But I just run this part and it worked for me: <a href="https://gist.github.com/dkastl/5617030#file-build_pgrouting-sh-L9-L13heers">https://gist.github.com/dkastl/5617030#file-build_pgrouting-sh-L9-L13heers</a></div><div>At least "html" worked for me. It seems PDF generation has errors.</div><div><br></div><div>Cheers,</div><div>Daniel</div><div><br></div><div><br></div><div><br></div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Sun, Jul 10, 2016 at 11:16 PM, Worth Lutz <span dir="ltr"><<a href="mailto:wal3@mindspring.com" target="_blank">wal3@mindspring.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div bgcolor="#FFFFFF" text="#000000">
<p>I tried all that and do not see where the updated documentation
ends up.</p>
<p>After doing the build, pointing to:<br>
</p>
<p> ~/pgrouting/build/doc/html/index.html <br>
</p>
<p>does not seem to work for me. I'm obviously missing something.</p>
<p>Thanks,<b><br>
</b></p>
<p><b>Worth Lutz</b><br>
</p><div><div class="h5">
<div>
<br>
<br>
</div>
<div>On 7/9/2016 10:06 AM, Daniel Kastl
wrote:<br>
</div>
<blockquote type="cite">
<p dir="ltr">Sorry, should be "cmake" of course.<br>
... auto correction... </p>
<div class="gmail_quote">On Jul 9, 2016 11:05 PM, "Daniel Kastl"
<<a href="mailto:daniel@georepublic.de" target="_blank">daniel@georepublic.de</a>>
wrote:<br type="attribution">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<p dir="ltr">The documentation is compiled with cake using a
special compile flag, see <a href="https://github.com/pgrouting/pgrouting/tree/develop#compilation" target="_blank">https://github.com/pgrouting/pgrouting/tree/develop#compilation</a></p>
<p dir="ltr">We probably need to make this easier to find in
the documentation ;-)</p>
<p dir="ltr">Cheers,<br>
Daniel </p>
<div class="gmail_quote">On Jul 9, 2016 9:15 PM, "Worth Lutz"
<<a href="mailto:wal3@mindspring.com" target="_blank">wal3@mindspring.com</a>>
wrote:<br type="attribution">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div bgcolor="#FFFFFF" text="#000000"> I have been side
tracked a bit but have been reading the documentation
extensively over the past week. I have had some success
working with my data and will be rereading the docs to
make sure my understanding is correct. I'll then commit
the corrections and additions I'm working on.<br>
<br>
How do I run the docs locally. I am familiar with
Sphinx but have not found the place to<br>
<blockquote><i>make html</i><br>
</blockquote>
I see a <i>make.bat</i> file but that is for Windows.
I normally work on Ubuntu and have a <i>Makefile</i> in
the directory as well as <i>make.bat</i>. Is
development normally done on Windows? And thus the <i>Makefile
</i>removed when make.bat was edited?<br>
<p>Thanks for your help.<br>
</p>
<div><i><b>Worth Lutz</b></i><br>
<br>
<br>
</div>
<div>On 7/8/2016 11:18 PM, Vicky Vergara wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">I merged code and more
documentation to develop.<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Here is a helpful link for
keeping up to date the branches:<br>
<a href="http://docs.pgrouting.org/doxy/2.3-dev-develop/index.html#up_to_date" target="_blank">http://docs.pgrouting.org/doxy/2.3-dev-develop/index.html#up_to_date</a><br>
<br>
</div>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On Wed, Jun 22, 2016 at
7:57 PM, Vicky Vergara <span dir="ltr"><<a href="mailto:vicky@georepublic.de" target="_blank"></a><a href="mailto:vicky@georepublic.de" target="_blank">vicky@georepublic.de</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Thanks<br>
</div>
</div>
<div>
<div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On Wed, Jun 22,
2016 at 2:10 PM, Worth Lutz <span dir="ltr"><<a href="mailto:wal3@mindspring.com" target="_blank"></a><a href="mailto:wal3@mindspring.com" target="_blank">wal3@mindspring.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div text="#000000" bgcolor="#FFFFFF">
Vicky,<br>
<br>
My github is at: <br>
<br>
<a href="https://github.com/worthlutz/pgrouting/" target="_blank">https://github.com/worthlutz/pgrouting/</a><br>
<br>
The branch I'll be using is <b>doc-improvements</b>
branched off <b>develop</b>.<br>
<br>
I'll let you know when I push some
changes.<span><font color="#888888"><br>
<br>
<div><b>Worth Lutz</b><br>
<br>
<br>
</div>
</font></span>
<div>
<div>
<div>On 06/22/2016 02:06 PM,
Vicky Vergara wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Tell
when you make the branch <br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">so I
can pinpoint where to find
the docuemtnation<br>
</div>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On
Wed, Jun 22, 2016 at 12:58
PM, Worth Lutz <span dir="ltr"><<a href="mailto:wal3@mindspring.com" target="_blank"></a><a href="mailto:wal3@mindspring.com" target="_blank">wal3@mindspring.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div bgcolor="#FFFFFF" text="#000000">
<p>Thanks Vicky. I'll
let you know what I
find.<span><font color="#888888"><br>
</font></span></p>
<span><font color="#888888">
<div><b>Worth Lutz</b><br>
<br>
<br>
</div>
</font></span>
<div>
<div>
<div>On 6/22/2016
1:53 PM, Vicky
Vergara wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Hello Worth Lutz.<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif"><br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">The documentation changes
you made them
to master or
to develop?<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Right now develop
documentation
has changed,
not in
everything put
it has lots of
changes.<br>
<a href="http://docs.pgrouting.org/dev/en/doc/index.html" target="_blank"></a><a href="http://docs.pgrouting.org/dev/en/doc/index.html" target="_blank">http://docs.pgrouting.org/dev/en/doc/index.html</a><br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">It is better for us to work
on the develop
branch which
has the 2.3
documentation.<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Its changing a lot. so to
have the
current
contents of
develop in
your for:<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">git checkout develop<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">git fetch upstream<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">git merge upstream/develop<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">git push<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">then in the github site you
will be able
to see that it
contains the
current
contents of
develop.<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Then you can branch to a
working
directory<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">git checkout -b
'improve/documentation'<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">then do a<br>
git push <br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">and give me the link to the
branch in your
repository so
that if I make
changes to
develop's
documentation,
I can make a
pull request
to your branch
with the
changes I
made.<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Work on the documentation,
and make pull
requests to
develop.<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">thanks.<br>
<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif">Vicky from the pgRouting
team<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif"><br>
<br>
<br>
</div>
<div class="gmail_default" style="font-family:comic sans ms,sans-serif"><br>
</div>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On
Wed, Jun 22,
2016 at 12:10
PM, Worth Lutz
<span dir="ltr"><<a href="mailto:wal3@mindspring.com" target="_blank"></a><a href="mailto:wal3@mindspring.com" target="_blank">wal3@mindspring.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div bgcolor="#FFFFFF" text="#000000">
<p>If I want
to work on
some
errors/typos
in the
documentation,
how do I do
that? <br>
</p>
<p>I've got a
fork and want
to create a
pull request.<br>
</p>
<p>Which
branch should
I be working
on?<br>
</p>
As I'm
starting a new
routing
project, I'm
reading (and
rereading) the
documentation
a lot and
think I should
fix what I
find.<span><font color="#888888"><br>
<br>
<div>-- <br>
<b>Worth Lutz</b><br>
<br>
<br>
</div>
</font></span></div>
<br>
_______________________________________________<br>
pgrouting-dev
mailing list<br>
<a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank"></a><a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank">pgrouting-dev@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" target="_blank"></a><a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a><br>
</blockquote>
</div>
<br>
<br clear="all">
<br>
-- <br>
<div data-smartmail="gmail_signature">
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<pre>Georepublic UG (haftungsbeschränkt)
Salzmannstraße 44,
81739 München, Germany
Vicky Vergara
Operations Research
eMail: vicky@<a href="http://georepublic.de" target="_blank">georepublic.de</a>
Web: <a href="https://georepublic.info" target="_blank">https://georepublic.info</a>
Tel: +49 (089) 4161 7698-1
Fax: +49 (089) 4161 7698-9
Commercial register: Amtsgericht München, HRB 181428
CEO: Daniel Kastl
<span></span></pre>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
pgrouting-dev mailing list
<a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank">pgrouting-dev@lists.osgeo.org</a>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a></pre>
</blockquote>
<br>
</div>
</div>
</div>
<br>
_______________________________________________<br>
pgrouting-dev mailing
list<br>
<a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank"></a><a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank">pgrouting-dev@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" rel="noreferrer" target="_blank"></a><a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a><br>
</blockquote>
</div>
<br>
<br clear="all">
<br>
-- <br>
<div data-smartmail="gmail_signature">
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<pre>Georepublic UG (haftungsbeschränkt)
Salzmannstraße 44,
81739 München, Germany
Vicky Vergara
Operations Research
eMail: vicky@<a href="http://georepublic.de" target="_blank">georepublic.de</a>
Web: <a href="https://georepublic.info" target="_blank">https://georepublic.info</a>
Tel: +49 (089) 4161 7698-1
Fax: +49 (089) 4161 7698-9
Commercial register: Amtsgericht München, HRB 181428
CEO: Daniel Kastl
<span></span></pre>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
pgrouting-dev mailing list
<a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank">pgrouting-dev@lists.osgeo.org</a>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a></pre>
</blockquote>
<br>
</div>
</div>
</div>
<br>
_______________________________________________<br>
pgrouting-dev mailing list<br>
<a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank">pgrouting-dev@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" rel="noreferrer" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a><br>
</blockquote>
</div>
<br>
<br clear="all">
<br>
-- <br>
<div data-smartmail="gmail_signature">
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<pre>Georepublic UG (haftungsbeschränkt)
Salzmannstraße 44,
81739 München, Germany
Vicky Vergara
Operations Research
eMail: vicky@<a href="http://georepublic.de" target="_blank">georepublic.de</a>
Web: <a href="https://georepublic.info" target="_blank">https://georepublic.info</a>
Tel: +49 (089) 4161 7698-1
Fax: +49 (089) 4161 7698-9
Commercial register: Amtsgericht München, HRB 181428
CEO: Daniel Kastl
<span></span></pre>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<br>
<br clear="all">
<br>
-- <br>
<div data-smartmail="gmail_signature">
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<div dir="ltr">
<pre>Georepublic UG (haftungsbeschränkt)
Salzmannstraße 44,
81739 München, Germany
Vicky Vergara
Operations Research
eMail: vicky@<a href="http://georepublic.de" target="_blank">georepublic.de</a>
Web: <a href="https://georepublic.info" target="_blank">https://georepublic.info</a>
Tel: +49 (089) 4161 7698-1
Fax: +49 (089) 4161 7698-9
Commercial register: Amtsgericht München, HRB 181428
CEO: Daniel Kastl
<span></span></pre>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
pgrouting-dev mailing list
<a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank">pgrouting-dev@lists.osgeo.org</a>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a></pre>
</blockquote>
<br>
</div>
<br>
_______________________________________________<br>
pgrouting-dev mailing list<br>
<a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank">pgrouting-dev@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" rel="noreferrer" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a><br>
</blockquote>
</div>
</blockquote>
</div>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
pgrouting-dev mailing list
<a href="mailto:pgrouting-dev@lists.osgeo.org" target="_blank">pgrouting-dev@lists.osgeo.org</a>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a></pre>
</blockquote>
<br>
</div></div></div>
<br>_______________________________________________<br>
pgrouting-dev mailing list<br>
<a href="mailto:pgrouting-dev@lists.osgeo.org">pgrouting-dev@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/pgrouting-dev" rel="noreferrer" target="_blank">http://lists.osgeo.org/mailman/listinfo/pgrouting-dev</a><br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><span style="font-family:arial,sans-serif;font-size:13px;border-collapse:collapse">Georepublic UG & Georepublic Japan<br>eMail: <a href="mailto:daniel.kastl@georepublic.de" style="color:rgb(66,99,171)" target="_blank">daniel.kastl@georepublic.de</a><br>Web: <a href="http://georepublic.info" style="color:rgb(66,99,171)" target="_blank">http://georepublic.info</a></span><div><br></div><div><br></div><div><br></div></div></div>
</div>