Hi,
I just noticed that the Trac wiki is not displaying updates to files kept in the source tree, for example http://projects.scipy.org/numpy/wiki/TestingGuidelines is stuck at an older version.
Can one of the admins point the ReST plugin to github?
Ralf
Thu, 04 Nov 2010 22:00:47 +0800, Ralf Gommers wrote:
I just noticed that the Trac wiki is not displaying updates to files kept in the source tree, for example http://projects.scipy.org/numpy/wiki/TestingGuidelines is stuck at an older version.
Can one of the admins point the ReST plugin to github?
That would require more work on the Trac-Git integration front:
http://github.com/pv/githubsimple-trac
It might be more cost-effective to just use links to the Github web interface.
On Thu, Nov 4, 2010 at 10:06 PM, Pauli Virtanen pav@iki.fi wrote:
Thu, 04 Nov 2010 22:00:47 +0800, Ralf Gommers wrote:
I just noticed that the Trac wiki is not displaying updates to files kept in the source tree, for example http://projects.scipy.org/numpy/wiki/TestingGuidelines is stuck at an older version.
Can one of the admins point the ReST plugin to github?
That would require more work on the Trac-Git integration front:
http://github.com/pv/githubsimple-trac
It might be more cost-effective to just use links to the Github web interface.
That will require renaming those files in the source tree from *.txt to *.rst, otherwise there's no way to have github render them properly. Unless I missed something. Would that be fine?
Ralf
On Sun, Nov 7, 2010 at 7:17 AM, Ralf Gommers ralf.gommers@googlemail.com wrote:
On Thu, Nov 4, 2010 at 10:06 PM, Pauli Virtanen pav@iki.fi wrote:
Thu, 04 Nov 2010 22:00:47 +0800, Ralf Gommers wrote:
I just noticed that the Trac wiki is not displaying updates to files kept in the source tree, for example http://projects.scipy.org/numpy/wiki/TestingGuidelines is stuck at an older version.
Can one of the admins point the ReST plugin to github?
That would require more work on the Trac-Git integration front:
http://github.com/pv/githubsimple-trac
It might be more cost-effective to just use links to the Github web interface.
That will require renaming those files in the source tree from *.txt to *.rst, otherwise there's no way to have github render them properly. Unless I missed something. Would that be fine?
I use .rst instead of .txt for my projects, so that github can render it properly. I don't know if that's the right solution, but it gets the job done.
Ondrej
On Sun, 7 Nov 2010, Ralf Gommers wrote:
That will require renaming those files in the source tree from *.txt to *.rst, otherwise there's no way to have github render them properly. Unless I missed something. Would that be fine?
I think a *.rst.txt extension would also be recognized by github.
Note that the docutils FAQ advises against using .rst as a file extension : http://docutils.sourceforge.net/FAQ.html#what-s-the-standard-filename-extens...
Cheers
2010/11/9 Sébastien Barthélemy sebastien.barthelemy@crans.org:
On Sun, 7 Nov 2010, Ralf Gommers wrote:
That will require renaming those files in the source tree from *.txt to *.rst, otherwise there's no way to have github render them properly. Unless I missed something. Would that be fine?
I think a *.rst.txt extension would also be recognized by github.
Yes it would, documented at https://github.com/github/markup.
Note that the docutils FAQ advises against using .rst as a file extension : http://docutils.sourceforge.net/FAQ.html#what-s-the-standard-filename-extens...
Good point. I agree .rst.txt is better.
Ralf
On Tue, Nov 9, 2010 at 10:24 PM, Ralf Gommers ralf.gommers@googlemail.com wrote:
2010/11/9 Sébastien Barthélemy sebastien.barthelemy@crans.org:
On Sun, 7 Nov 2010, Ralf Gommers wrote:
That will require renaming those files in the source tree from *.txt to *.rst, otherwise there's no way to have github render them properly. Unless I missed something. Would that be fine?
I think a *.rst.txt extension would also be recognized by github.
Yes it would, documented at https://github.com/github/markup.
Note that the docutils FAQ advises against using .rst as a file extension : http://docutils.sourceforge.net/FAQ.html#what-s-the-standard-filename-extens...
Good point. I agree .rst.txt is better.
Renaming all files under doc/ done in https://github.com/rgommers/numpy/tree/rest-files-extension. For an example of how github renders this see https://github.com/rgommers/numpy/blob/rest-files-extension/doc/TESTS.rst.tx... Looks good to me - we can just link to it from the Trac wiki. Will push this in a few days unless I hear otherwise.
Cheers, Ralf
participants (4)
-
Ondrej Certik -
Pauli Virtanen -
Ralf Gommers -
Sébastien Barthélemy