Great work! Josh Juneau j
> On Feb 23, 2018, at 1:19 AM, Antonio <[email protected]> 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: [email protected] > For additional commands, e-mail: [email protected] > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > >
