Looks good, what timelines do you have for the migration? On 23 Feb 2018 12:11, "Josh Juneau" <juneau...@gmail.com> wrote:
> Great work! > > Josh Juneau > j > > > On Feb 23, 2018, at 1:19 AM, Antonio <anto...@vieiro.net> wrote: > > > > Hi all, > > > > Wade, Tim, Neil, Jirka, Geertjan and I have been doing some experiments > regarding the NetBeans website. > > > > As you probably know, the current NetBeans website comprises many > different webs: we have "bits.netbeans.org" for APIs, "netbeans.org" for > main content, "plugins.netbeans.org" for the Plugin Portal, " > wiki.netbeans.org" for the wiki, and there're a few more subdomains. > > > > The current "netbeans.org" website is quite big. As you already know, > Wade consolidated it in github's "apache/incubator-netbeans-website-cleanup" > [1] repo, and added a Gradle build system that uses JBake to generate > static content, where content is markdown/asciidoc/html with some > additional files. > > > > As the migration is going to take time, and will require Oracle > reviewing IP clearance for the content, we thought we could start a simpler > "netbeans.apache.org" website that uses the same Wade's scripts. We then > could add content gradually, as Oracle passes the IP clearance procedures. > > > > So we came out with a basic "multisite-test" _branch_ at Github's > "incubator-netbeans-website" [2]. > > > > The idea of this branch is to be able to consolidate different NetBeans > subdomains as different directories (currently "bits.netbeans.org" and " > netbeans.apache.org"), and create scripts for generating _static_ content > for those different websites. Currently we have: > > > > - bits.netbeans.org > > Currently builds the javadoc from sources. > > > > - netbeans.apache.org > > - Has some basic content from current Confluence pages. > > - As posted to the list in december we chose the Foundation 6 > framework as a, well, foundation, and Neil modified it with some proper > SCSS structure [3] to fit our needs. > > - We've also added the wiki pages. We may set up a different repo for > these in the future, though. > > - We've uploaded the result of this static site to > https://netbeans.vieiro.net for you to see live (note: the "see this page > in github" won't work until/if this branch merges to master). > > > > So to summarize, the objectives are: > > > > 1. Have all NetBeans websites in a single repo, with different folders > for each. Maybe we want to share stuff among them in the future. > > 2. Have some scripts to build static content for those websites. > > 3. For web sites, make them comply with Apache's guidelines for web > sites [4] > > > > If you think the idea is good enough then we may merge that branch into > master and start migrating content, and/or creating different > subdirectories for other websites (such as the plugin portal, for instance). > > > > So, please, say yes or no to keep this path of work. Some other ideas > would also we welcome. > > > > Kind regards, > > Antonio > > > > > > [1] > > https://github.com/apache/incubator-netbeans-website-cleanup > > > > [2] > > https://github.com/apache/incubator-netbeans-website/tree/multisite-test > > > > We've used asciidoc, but Wade's script supports markdown and html as > well. An example asciidoc file, as rendered by github, can be seen here: > > > > https://github.com/apache/incubator-netbeans-website/ > blob/multisite-test/netbeans.apache.org/src/content/ > download/index.asciidoc > > > > [3] > > Neil's impressive SCSS organization is here: > > https://github.com/apache/incubator-netbeans-website/ > tree/multisite-test/netbeans.apache.org/src/content/scss > > > > (note: some low quality scss stuff in there is my fault, not Neil's) > > > > [4] > > > > Apache Navigation Links Policy > > https://www.apache.org/foundation/marks/pmcs#navigation > > > > Incubator Branding Guide > > http://incubator.apache.org/guides/branding.html > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: dev-unsubscr...@netbeans.incubator.apache.org > > For additional commands, e-mail: dev-h...@netbeans.incubator.apache.org > > > > For further information about the NetBeans mailing lists, visit: > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > > > > >
