Migrating website to Jekyll

Good ideas from everyone…

I’m still working through issues in the “tutorials” and “teaching” sections, but it’s getting closer.

I think one remaining question is how to indicate “please edit this site” (e.g., adding pages). I can write up a how-to, but I’m not sure where to hang it. Maybe I need to add a “contributing” link to the top navigation?

-Geoff

On Mon, Dec 1, 2014 at 7:44 AM Jens linucks42@gmail.com wrote:
Hi Geoff,

I think it looks really good - nice and clean, and easy to navigate.

Having said I think the front page is possibly a little too sparse and some more pictures showing avogadro in action, or just some flashy rendering would probably add something.

I noticed one issue. On the tutorials page (http://avogadro.github.io/tutorials/ http://avogadro.github.io/tutorials/) if I hover over the first “Tutorials:Getting started” link, clicking on it (it links to"tutorials:Getting started") doesn’t do anything. There’s another Tutorials:Getting started" link further down which does work and links to http://avogadro.github.io/tutorials/getting_started.html http://avogadro.github.io/tutorials/getting_started.html

I also don’t get to the paper when I click on the “The Avogadro Paper” link (http://dx.doi.org/10.1186/1758-2946-4-17 http://dx.doi.org/10.1186/1758-2946-4-17).

Best wishes,

Jens

On 30 November 2014 at 18:09, Geoffrey Hutchison <geoff.hutchison@gmail.com mailto:geoff.hutchison@gmail.com> wrote:
Short summary: I have a beta site at http://avogadro.github.io/ http://avogadro.github.io/ (not the permanent home) and want feedback

I mentioned this previously, but I’ve made significant progress in extracting everything from MediaWiki and getting a functional Jekyll site going.

I’m tired of maintaining MediaWiki, and I dislike the theme/skins and the spam issues. I looked around at possibilities, and thought that using a static site generator like Jekyll would be a great idea:

  • People can still edit the Git repository
  • No security issues
  • Infinitely customizable
  • Easier to translate and mirror (and distribute with Avogadro itself)

While there were many concerns, particularly about editing, there seemed to be general support. It took a bit of time to wrap my head around Jekyll, but I’ve migrated almost everything from MediaWiki.

I’d definitely like some feedback. Please take a look at http://avogadro.github.io/ http://avogadro.github.io/

  • What you like
  • What you don’t
  • Bugs or missing content (e.g., it looks horrible on platform X or browser Y)
  • How to easily say “if you want to edit/improve this, please do X” on the site

A lot of things need updating, and I’ll be hiring a small team of undergraduates starting in January to update and complete an Avogadro v1 (and eventually v2) manual, including thorough tutorials and screencasts.

Thanks,
-Geoff

P.S. The developer docs are there too, but I’m thinking these should really be migrated to GitHub wiki pages to “live” with the repositories themselves.


Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports, App Integration & more
Get technology previously reserved for billion-dollar corporations, FREE
http://pubads.g.doubleclick.net/gampad/clk?id=157005751&iu=/4140/ostg.clktrk http://pubads.g.doubleclick.net/gampad/clk?id=157005751&iu=/4140/ostg.clktrk


Avogadro-devel mailing list
Avogadro-devel@lists.sourceforge.net mailto:Avogadro-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/avogadro-devel https://lists.sourceforge.net/lists/listinfo/avogadro-devel

Short summary: I have a beta site at http://avogadro.github.io/ (not the permanent home) and want feedback

I mentioned this previously, but I’ve made significant progress in extracting everything from MediaWiki and getting a functional Jekyll site going.

I’m tired of maintaining MediaWiki, and I dislike the theme/skins and the spam issues. I looked around at possibilities, and thought that using a static site generator like Jekyll would be a great idea:

  • People can still edit the Git repository
  • No security issues
  • Infinitely customizable
  • Easier to translate and mirror (and distribute with Avogadro itself)

While there were many concerns, particularly about editing, there seemed to be general support. It took a bit of time to wrap my head around Jekyll, but I’ve migrated almost everything from MediaWiki.

I’d definitely like some feedback. Please take a look at http://avogadro.github.io/

  • What you like
  • What you don’t
  • Bugs or missing content (e.g., it looks horrible on platform X or browser Y)
  • How to easily say “if you want to edit/improve this, please do X” on the site

A lot of things need updating, and I’ll be hiring a small team of undergraduates starting in January to update and complete an Avogadro v1 (and eventually v2) manual, including thorough tutorials and screencasts.

Thanks,
-Geoff

P.S. The developer docs are there too, but I’m thinking these should really be migrated to GitHub wiki pages to “live” with the repositories themselves.

Hi,

On Sun, Nov 30, 2014 at 01:09:34PM -0500, Geoffrey Hutchison wrote:

Short summary: I have a beta site at http://avogadro.github.io/ (not
the permanent home) and want feedback

Well, look nice. Not really on-topic here I guess, but while clicking
on various links on that website, I noticed that the Avogadro paper DOI
link is broken. Doesn’t look like a typo to me, so maybe J. Cheminf. is
having issues? Is anybody seeing this as well?

Michael

On 11/30/2014 01:09 PM, Geoffrey Hutchison wrote:

Short summary: I have a beta site at http://avogadro.github.io/ (not
the permanent home) and want feedback

I mentioned this previously, but I’ve made significant progress in
extracting everything from MediaWiki and getting a functional Jekyll
site going.

I’m tired of maintaining MediaWiki, and I dislike the theme/skins and
the spam issues. I looked around at possibilities, and thought that
using a static site generator like Jekyll would be a great idea:

  • People can still edit the Git repository
  • No security issues
  • Infinitely customizable
  • Easier to translate and mirror (and distribute with Avogadro itself)

While there were many concerns, particularly about editing, there seemed
to be general support. It took a bit of time to wrap my head around
Jekyll, but I’ve migrated almost everything from MediaWiki.

I’d definitely like some feedback. Please take a look at
http://avogadro.github.io/

  • What you like
  • What you don’t
  • Bugs or missing content (e.g., it looks horrible on platform X or
    browser Y)
  • How to easily say “if you want to edit/improve this, please do X” on
    the site

A lot of things need updating, and I’ll be hiring a small team of
undergraduates starting in January to update and complete an Avogadro v1
(and eventually v2) manual, including thorough tutorials and screencasts.

Thanks,
-Geoff

P.S. The developer docs are there too, but I’m thinking these should
really be migrated to GitHub wiki pages to “live” with the repositories
themselves.


Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports, App Integration & more
Get technology previously reserved for billion-dollar corporations, FREE
http://pubads.g.doubleclick.net/gampad/clk?id=157005751&iu=/4140/ostg.clktrk


Avogadro-devel mailing list
Avogadro-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/avogadro-devel

To Geoff,

It looks good to me. I suggest getting an SVG of the Avogadro icon on
the frontpage. I see jagged edges on my computer.

From,
Mark

Hi Geoff,

I think it looks really good - nice and clean, and easy to navigate.

Having said I think the front page is possibly a little too sparse and some
more pictures showing avogadro in action, or just some flashy rendering
would probably add something.

I noticed one issue. On the tutorials page (
http://avogadro.github.io/tutorials/) if I hover over the first
"Tutorials:Getting started" link, clicking on it (it links
to"tutorials:Getting started") doesn’t do anything. There’s another
Tutorials:Getting started" link further down which does work and links to
http://avogadro.github.io/tutorials/getting_started.html

I also don’t get to the paper when I click on the “The Avogadro Paper” link
(http://dx.doi.org/10.1186/1758-2946-4-17).

Best wishes,

Jens

On 30 November 2014 at 18:09, Geoffrey Hutchison geoff.hutchison@gmail.com
wrote:

Short summary: I have a beta site at http://avogadro.github.io/ (not
the permanent home) and want feedback

I mentioned this previously, but I’ve made significant progress in
extracting everything from MediaWiki and getting a functional Jekyll site
going.

I’m tired of maintaining MediaWiki, and I dislike the theme/skins and the
spam issues. I looked around at possibilities, and thought that using a
static site generator like Jekyll would be a great idea:

  • People can still edit the Git repository
  • No security issues
  • Infinitely customizable
  • Easier to translate and mirror (and distribute with Avogadro itself)

While there were many concerns, particularly about editing, there seemed
to be general support. It took a bit of time to wrap my head around Jekyll,
but I’ve migrated almost everything from MediaWiki.

I’d definitely like some feedback. Please take a look at
http://avogadro.github.io/

  • What you like
  • What you don’t
  • Bugs or missing content (e.g., it looks horrible on platform X or
    browser Y)
  • How to easily say “if you want to edit/improve this, please do X” on the
    site

A lot of things need updating, and I’ll be hiring a small team of
undergraduates starting in January to update and complete an Avogadro v1
(and eventually v2) manual, including thorough tutorials and screencasts.

Thanks,
-Geoff

P.S. The developer docs are there too, but I’m thinking these should
really be migrated to GitHub wiki pages to “live” with the repositories
themselves.


Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports, App Integration & more
Get technology previously reserved for billion-dollar corporations, FREE

http://pubads.g.doubleclick.net/gampad/clk?id=157005751&iu=/4140/ostg.clktrk


Avogadro-devel mailing list
Avogadro-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/avogadro-devel