Stephen, please correct me where I'm wrong, but after mirroring the site and removing docs and javadocs since these are generated, it would appear that there are only 7 html files to the website. It's not clear to me that at this point the effort of creating or moving to a template engine is worth the effort. I would rather see the static site as-is move to version control sooner rather than later and not hinge upon generation.
On Wed, Aug 3, 2016 at 1:38 PM, Dylan Millikin <dylan.milli...@gmail.com> wrote: > The groovy template engine could work just fine. > FYI : > http://stackoverflow.com/questions/3793880/lightweight-template-engine-in-java > There might be a few interested template engines there as well. > > On Wed, Aug 3, 2016 at 9:40 AM, Stephen Mallette <spmalle...@gmail.com> > wrote: > >> Yeah - i'm not so good with the sed to the awk to the grep or whatever so >> if it can be that simple that would be awesome. The groovy template engine >> might be another option. Something like that would work easy enough too I >> would guess. I really don't think we need much more than that right now. >> >> Organizationally, I think we should have a /site directory at the root of >> the repo to house the images/html template content and then have it >> generate into root /target/site from bin/generate-site.sh. >> >> On Wed, Aug 3, 2016 at 9:29 AM, Dylan Millikin <dylan.milli...@gmail.com> >> wrote: >> >> > Hmm sounds like what we would want would be a template engine that would >> > help us build the static site. >> > If all we need are includes that put together html partials >> > (headers/footers) we could make our own. It could be as simple as using >> sed >> > in bin/generate-web-site.sh >> > >> > On Wed, Aug 3, 2016 at 9:03 AM, Stephen Mallette <spmalle...@gmail.com> >> > wrote: >> > >> > > yes - static html/css and it sucks a bit because we don't have any >> re-use >> > > going on there. so if we have to change a menu or something it means >> > > changing it on every page in the site. would be nice to have some >> > re-usable >> > > headers/footers and such. i looked into some static site generators a >> > while >> > > back, but they all seemed like they did too much. maybe i didn't know >> > what >> > > to look for. >> > > >> > > On Wed, Aug 3, 2016 at 9:00 AM, Dylan Millikin < >> dylan.milli...@gmail.com >> > > >> > > wrote: >> > > >> > > > How is the current site structured? Is it just HTML and CSS files? >> > > > >> > > > On Tue, Aug 2, 2016 at 6:20 PM, Stephen Mallette < >> spmalle...@gmail.com >> > > >> > > > wrote: >> > > > >> > > > > no - we don't have one for the main web site. i've wanted to >> suggest >> > > that >> > > > > we change that though and generate the main web site from the >> github >> > > > repo. >> > > > > in that way we could easily accept pull requests and such. i don't >> > > think >> > > > we >> > > > > want to take a full asciidoc approach and the web site generation >> > would >> > > > > probably stay separate from the doc generation, but it would be >> nice >> > if >> > > > we >> > > > > could bin/generate-web-site.sh for a local build of that that thing >> > > which >> > > > > could then be published to the apache svn repo. anyone else like >> that >> > > > idea? >> > > > > if so, how would it best be done? >> > > > > >> > > > > >> > > > > >> > > > > On Tue, Aug 2, 2016 at 5:05 PM, Robert Dale <robd...@gmail.com> >> > wrote: >> > > > > >> > > > > > Is there a git repo for this and the main website? I would like >> to >> > > > > > make pull requests to fix some things. >> > > > > > >> > > > > > On Fri, Jul 29, 2016 at 1:49 PM, Stephen Mallette < >> > > > spmalle...@gmail.com> >> > > > > > wrote: >> > > > > > > The download page is now "live" >> > > > > > > >> > > > > > > On Thu, Jul 28, 2016 at 7:14 PM, Stephen Mallette < >> > > > > spmalle...@gmail.com> >> > > > > > > wrote: >> > > > > > > >> > > > > > >> I assume everyone is cool with making the Download Page live >> at >> > > this >> > > > > > point >> > > > > > >> as there's been no other feedback in the last few days. I'll >> > > > probably >> > > > > > make >> > > > > > >> some adjustments to the web site tomorrow to bring it online >> > > > publicly. >> > > > > > >> >> > > > > > >> On Mon, Jul 25, 2016 at 7:33 AM, Stephen Mallette < >> > > > > spmalle...@gmail.com >> > > > > > > >> > > > > > >> wrote: >> > > > > > >> >> > > > > > >>> I updated the downloads page some more: >> > > > > > >>> >> > > > > > >>> + tweaked the date format a bit to "really" match the rest of >> > the >> > > > > site >> > > > > > >>> (which is still inconsistent in other places like changelog - >> > > dah) >> > > > > > >>> + added a "verifying downloads" section which talks about >> > > > > GPG/PGP/etc. >> > > > > > >>> >> > > > > > >>> http://tinkerpop.apache.org/downloads.html >> > > > > > >>> >> > > > > > >>> >> > > > > > >>> >> > > > > > >>> >> > > > > > >>> On Fri, Jul 22, 2016 at 3:53 PM, Stephen Mallette < >> > > > > > spmalle...@gmail.com> >> > > > > > >>> wrote: >> > > > > > >>> >> > > > > > >>>> Good feedback Robert/Jason. >> > > > > > >>>> >> > > > > > >>>> Updated: >> > > > > > >>>> >> > > > > > >>>> http://tinkerpop.apache.org/downloads.html >> > > > > > >>>> >> > > > > > >>>> Added documentation and included some descriptors to current >> > > > > releases. >> > > > > > >>>> Didn't change the date format for now - that's the format we >> > use >> > > > > > everywhere >> > > > > > >>>> around "release" so didn't want to muck with that at this >> > point. >> > > > > > >>>> >> > > > > > >>>> >> > > > > > >>>> >> > > > > > >>>> On Fri, Jul 22, 2016 at 3:36 PM, Robert Dale < >> > robd...@gmail.com >> > > > >> > > > > > wrote: >> > > > > > >>>> >> > > > > > >>>>> Stephen, I think what Sebb might be getting at is that some >> > > > things >> > > > > > >>>>> should be spelled out even if they are obvious to some. I >> > agree >> > > > > with >> > > > > > >>>>> this. >> > > > > > >>>>> >> > > > > > >>>>> 3.2.1 (latest, stable) >> > > > > > >>>>> 3.1.3 (bug fixes only) >> > > > > > >>>>> >> > > > > > >>>>> I think the dates should be in ISO8601 format. YYYY-MM-DD >> > > > > > >>>>> >> > > > > > >>>>> Otherwise, I think it looks very good. >> > > > > > >>>>> >> > > > > > >>>>> -- >> > > > > > >>>>> Robert Dale >> > > > > > >>>>> >> > > > > > >>>>> On Fri, Jul 22, 2016 at 2:51 PM, Jason Plurad < >> > > plur...@gmail.com >> > > > > >> > > > > > >>>>> wrote: >> > > > > > >>>>> > +1 looks great. >> > > > > > >>>>> > >> > > > > > >>>>> > Link to the documentation, maybe next to the release >> notes >> > > > link, >> > > > > > >>>>> would be >> > > > > > >>>>> > useful too. >> > > > > > >>>>> > >> > > > > > >>>>> > -- Jason >> > > > > > >>>>> > >> > > > > > >>>>> > On Fri, Jul 22, 2016 at 2:07 PM, Stephen Mallette < >> > > > > > >>>>> spmalle...@gmail.com> >> > > > > > >>>>> > wrote: >> > > > > > >>>>> > >> > > > > > >>>>> >> I think it might be a good idea to include a "Download >> > Page" >> > > > on >> > > > > > our >> > > > > > >>>>> web >> > > > > > >>>>> >> site. It would let us better list the versions we have >> out >> > > > there >> > > > > > and >> > > > > > >>>>> would >> > > > > > >>>>> >> get us better in line with Apache Infrastructure - for >> > > > example: >> > > > > > >>>>> >> >> > > > > > >>>>> >> https://issues.apache.org/jira/browse/TINKERPOP-1255 >> > > > > > >>>>> >> >> > > > > > >>>>> >> I'm also seeing that we yet have spots where we dont' >> link >> > > to >> > > > > the >> > > > > > >>>>> mirror >> > > > > > >>>>> >> system. And finally, it would be nice to have a >> "generic" >> > > > > download >> > > > > > >>>>> page >> > > > > > >>>>> >> where we could point external links to - like the new >> > > > > > "documentation" >> > > > > > >>>>> >> feature in StackOverflow (right now it's sorta hardcoded >> > to >> > > > the >> > > > > > >>>>> mirror >> > > > > > >>>>> >> which isn't so good because we'll have to change that >> all >> > > the >> > > > > > time). >> > > > > > >>>>> >> >> > > > > > >>>>> >> I quickly took a swipe at such a page: >> > > > > > >>>>> >> >> > > > > > >>>>> >> http://tinkerpop.apache.org/downloads.html >> > > > > > >>>>> >> >> > > > > > >>>>> >> It is NOT "linked to" by anything at this point so it is >> > > > > > "hidden". I >> > > > > > >>>>> just >> > > > > > >>>>> >> wanted to have something that everyone could look at to >> > get >> > > > the >> > > > > > idea >> > > > > > >>>>> of >> > > > > > >>>>> >> what such a page might look like. >> > > > > > >>>>> >> >> > > > > > >>>>> >> Thoughts? >> > > > > > >>>>> >> >> > > > > > >>>>> >> Thanks, >> > > > > > >>>>> >> >> > > > > > >>>>> >> Stephen >> > > > > > >>>>> >> >> > > > > > >>>>> >> > > > > > >>>> >> > > > > > >>>> >> > > > > > >>> >> > > > > > >> >> > > > > > >> > > > > > >> > > > > > >> > > > > > -- >> > > > > > Robert Dale >> > > > > > >> > > > > >> > > > >> > > >> > >> -- Robert Dale