Discussion:
[Docutils-develop] Website
Roberto Alsina
2017-05-29 20:37:25 UTC
Permalink
Hi people!

The website for docutils is a bit ... oldfashioned, let's say?

Were I to volunteer to:

1) Make it nicer (within the parameters of me not being a web developer)
2) Add search to it
3) Keep all the URLs in place so nothing is moved

would you be ok with that?

Where is it stored?
engelbert gruber
2017-05-30 11:17:19 UTC
Permalink
on shell.sourceforge.net:/home/project-web/docutils/htdocs

cheers
Post by Roberto Alsina
Hi people!
The website for docutils is a bit ... oldfashioned, let's say?
1) Make it nicer (within the parameters of me not being a web developer)
2) Add search to it
3) Keep all the URLs in place so nothing is moved
would you be ok with that?
Where is it stored?
------------------------------------------------------------
------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
https://lists.sourceforge.net/lists/listinfo/docutils-develop
Please use "Reply All" to reply to the list.
Roberto Alsina
2017-05-30 16:42:27 UTC
Permalink
1st attempt at POC modernizing the docutils website.

* I did a git clone (sorry, needed for netlify, see below)
* I created a subdir "site" with links to the right things in it and a
conf.py for Nikola, my SSG
* added some files so changes in it are picked up by netlify
* so, here it is: http://docutils-test-site.netlify.com/
* sources to the interesting parts here: https://github.com/ralsina/docutils

Caveats:

* This needs a feature in Nikola that is not in master yet: extraction of
metadata from docinfo fields
* Dates via SVN keywords did not work for obvious reasons, so it's
monkeypatched to a dummy date
* All other SVN keywords did not work

If this is considered worth pursuing, I am happy to put more effort into it.
Post by engelbert gruber
on shell.sourceforge.net:/home/project-web/docutils/htdocs
cheers
Post by Roberto Alsina
Hi people!
The website for docutils is a bit ... oldfashioned, let's say?
1) Make it nicer (within the parameters of me not being a web developer)
2) Add search to it
3) Keep all the URLs in place so nothing is moved
would you be ok with that?
Where is it stored?
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
https://lists.sourceforge.net/lists/listinfo/docutils-develop
Please use "Reply All" to reply to the list.
David Goodger
2017-06-01 19:55:38 UTC
Permalink
* It looks good, thanks!

* I am unable to test the site at work, as it seems that the
stylesheets are prohibited by our internet censor. The content itself
(html) is not though. Strange. (Maybe "assets" gets truncated in the
filter...) I am only able to comment on what I can see on my phone
(Android, using Chrome browser). I'll look at it using a desktop
browser from home later.

* On the mobile site, the left & right margins are excessive, removing
about 25% of the horizontal space.

* Thanks for not succumbing to the 80% gray trope that most sites use.
100% black text on white is best for contrast & readability.

* To date, the Docutils website has been self-sufficient. Apart from
some scripts and makefiles, there is no 3rd-party software needed to
generate the Docutils website. I'd like to keep it that way. This
means that, unfortunately, I'd rather *not* use Nikola or any other
site-generating software on the site, if only to avoid the impression
of favouritism.

* Improvements to the CSS are greatly appreciated.

When you asked, "Where is it stored?", did you mean where is the
source kept? (Engelbert answered where the HTML is hosted.) The source
is a combination of the documents in the Docutils trunk docs/
directory, and the documents here:
svn+ssh://svn.code.sf.net/p/docutils/code/trunk/web
The build script, docutils-update.local, is here:
svn+ssh://svn.code.sf.net/p/docutils/code/trunk/sandbox/infrastructure

David Goodger
<http://python.net/~goodger>
Post by Roberto Alsina
1st attempt at POC modernizing the docutils website.
* I did a git clone (sorry, needed for netlify, see below)
* I created a subdir "site" with links to the right things in it and a
conf.py for Nikola, my SSG
* added some files so changes in it are picked up by netlify
* so, here it is: http://docutils-test-site.netlify.com/
* sources to the interesting parts here: https://github.com/ralsina/docutils
* This needs a feature in Nikola that is not in master yet: extraction of
metadata from docinfo fields
* Dates via SVN keywords did not work for obvious reasons, so it's
monkeypatched to a dummy date
* All other SVN keywords did not work
If this is considered worth pursuing, I am happy to put more effort into it.
On Tue, May 30, 2017 at 8:17 AM engelbert gruber
Post by engelbert gruber
on shell.sourceforge.net:/home/project-web/docutils/htdocs
cheers
Post by Roberto Alsina
Hi people!
The website for docutils is a bit ... oldfashioned, let's say?
1) Make it nicer (within the parameters of me not being a web developer)
2) Add search to it
3) Keep all the URLs in place so nothing is moved
would you be ok with that?
Where is it stored?
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
https://lists.sourceforge.net/lists/listinfo/docutils-develop
Please use "Reply All" to reply to the list.
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
https://lists.sourceforge.net/lists/listinfo/docutils-develop
Please use "Reply All" to reply to the list.
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
Docutils-***@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/docutils-develop

Please use "Reply All" to reply to the list.
Roberto Alsina
2017-06-01 19:58:27 UTC
Permalink
Ok, then, if you don't want to use any 3rd party software, then the site
will keep looking like it does now, I guess. There is a reason why SSGs
were invented :-)

It was a fun experiment, at least.
Post by David Goodger
* It looks good, thanks!
* I am unable to test the site at work, as it seems that the
stylesheets are prohibited by our internet censor. The content itself
(html) is not though. Strange. (Maybe "assets" gets truncated in the
filter...) I am only able to comment on what I can see on my phone
(Android, using Chrome browser). I'll look at it using a desktop
browser from home later.
* On the mobile site, the left & right margins are excessive, removing
about 25% of the horizontal space.
* Thanks for not succumbing to the 80% gray trope that most sites use.
100% black text on white is best for contrast & readability.
* To date, the Docutils website has been self-sufficient. Apart from
some scripts and makefiles, there is no 3rd-party software needed to
generate the Docutils website. I'd like to keep it that way. This
means that, unfortunately, I'd rather *not* use Nikola or any other
site-generating software on the site, if only to avoid the impression
of favouritism.
* Improvements to the CSS are greatly appreciated.
When you asked, "Where is it stored?", did you mean where is the
source kept? (Engelbert answered where the HTML is hosted.) The source
is a combination of the documents in the Docutils trunk docs/
svn+ssh://svn.code.sf.net/p/docutils/code/trunk/web
svn+ssh://svn.code.sf.net/p/docutils/code/trunk/sandbox/infrastructure
David Goodger
<http://python.net/~goodger>
Post by Roberto Alsina
1st attempt at POC modernizing the docutils website.
* I did a git clone (sorry, needed for netlify, see below)
* I created a subdir "site" with links to the right things in it and a
conf.py for Nikola, my SSG
* added some files so changes in it are picked up by netlify
* so, here it is: http://docutils-test-site.netlify.com/
https://github.com/ralsina/docutils
Post by Roberto Alsina
* This needs a feature in Nikola that is not in master yet: extraction of
metadata from docinfo fields
* Dates via SVN keywords did not work for obvious reasons, so it's
monkeypatched to a dummy date
* All other SVN keywords did not work
If this is considered worth pursuing, I am happy to put more effort into
it.
Post by Roberto Alsina
On Tue, May 30, 2017 at 8:17 AM engelbert gruber
Post by engelbert gruber
on shell.sourceforge.net:/home/project-web/docutils/htdocs
cheers
Post by Roberto Alsina
Hi people!
The website for docutils is a bit ... oldfashioned, let's say?
1) Make it nicer (within the parameters of me not being a web
developer)
Post by Roberto Alsina
Post by engelbert gruber
Post by Roberto Alsina
2) Add search to it
3) Keep all the URLs in place so nothing is moved
would you be ok with that?
Where is it stored?
------------------------------------------------------------------------------
Post by Roberto Alsina
Post by engelbert gruber
Post by Roberto Alsina
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
https://lists.sourceforge.net/lists/listinfo/docutils-develop
Please use "Reply All" to reply to the list.
------------------------------------------------------------------------------
Post by Roberto Alsina
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
https://lists.sourceforge.net/lists/listinfo/docutils-develop
Please use "Reply All" to reply to the list.
Roberto Alsina
2017-06-10 15:13:43 UTC
Permalink
If no proper tools can be used for this I am not interested on working on
it anymore.
Feel free to take whatever is there and use it if anyone else is interested
on doing it.

On Sat, Jun 10, 2017 at 9:05 AM Guenter Milde via Docutils-develop <
How about using rst2html5 for the docs?
Post by David Goodger
* On the mobile site, the left & right margins are excessive, removing
about 25% of the horizontal space.
...
Post by David Goodger
* Improvements to the CSS are greatly appreciated.
The CSS for the HTML5 writer is designed to have
not too long lines (for easier reading) but small margins on small screens.
Try it out.
GÃŒnter
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
https://lists.sourceforge.net/lists/listinfo/docutils-develop
Please use "Reply All" to reply to the list.
David Goodger
2017-06-14 23:48:26 UTC
Permalink
On Sat, Jun 10, 2017 at 7:02 AM, Guenter Milde via Docutils-develop
How about using rst2html5 for the docs?
As long as that doesn't have a negative impact on website visitors,
fine. I'd rather be conservative with adoption.

What does the browser compatibility picture look like? What happens if
someone with an incompatible browser visits?
Post by David Goodger
* On the mobile site, the left & right margins are excessive, removing
about 25% of the horizontal space.
...
Post by David Goodger
* Improvements to the CSS are greatly appreciated.
The CSS for the HTML5 writer is designed to have
not too long lines (for easier reading) but small margins on small screens.
Try it out.
Sure, when I have enough round tuits...

David Goodger
<http://python.net/~goodger>

------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-develop mailing list
Docutils-***@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/docutils-develop

Please use "Reply All" to reply to the list.

Continue reading on narkive:
Loading...