I would like to Change the logo to the SVG file, because it scales better and 
we don’t have any Problems with Retina and whatever, as you can see it here: 
http://netbeans.apache.org/. I added the SVG too.


Cheers

Chris

Von: Antonio
Gesendet: Montag, 26. Februar 2018 08:54
An: dev@netbeans.incubator.apache.org
Betreff: Merged to master (was Re: A NetBeans website proposal)

Hi all,

This has now been merged to master, we think we comply with ASF's 
podling website requirements. Feel free to submit PRs as you see fit.

I've uploaded the bits at https://netbeans.vieiro.net temporarily, to 
verify that the "see this page in github" links work properly. This 
won't track master, and may dissappear within a few days.

Thanks all involved and those giving comments and ideas.

Have fun,
Antonio

== Main goals

As Geertjan outlined in the mailing list thread the main goals for the 
netbeans.apache.org website are, in order of importance:

1- Have a proper IDE features page.
2- Port the IDE tutorials.
3- Have a platform specific page.

Some other enhancements & to-dos as seen in the thread & elsewhere:

- Improve image visualization (lightbox, for instance).
- Add proper retina images (including the NetBeans logo).
- The wiki pages should be reviewed, after review the bottom of the page 
should contain the review date.

== Going live

AFAIK the website won't go live until we update the content to the 
"asf-site" branch (i.e., until we copy the generated HTML into that 
branch), as I think this branch is currently connected with the web 
server through Apache's gitpubsub.

I'll try to find out the details.

== netbeans.apache.org help materials

- The README at
https://github.com/apache/incubator-netbeans-website/tree/master/netbeans.apache.org
explains how Wade's script work, how to run a preview site yourself, etc.

- The templates directory README
https://github.com/apache/incubator-netbeans-website/tree/master/netbeans.apache.org/src/content/templates
has information about building templates as "Groovy Server Pages" files, 
as well as the initial templates we're using.

- The scss directory at
https://github.com/apache/incubator-netbeans-website/tree/master/netbeans.apache.org/src/content/scss
Contains the initial SCSS files from Foundation adapted to netbeans.

Other useful links:

- jbake http://jbake.org/docs/2.5.1/
- foundation 6 for sites https://foundation.zurb.com/sites/docs/
- for those using asciidoc the AsciiDoc Writer's Guide at 
https://asciidoctor.org/docs/asciidoc-writers-guide/

== bits.netbeans.org

The ant script at bits.netbeans.org needs some love to properly generate 
NetBeans javadoc files + arch stuff (properly tagged with release 
information, etc.). The directory structure from current 
"bits.netbeans.org" does not match the existing one.

AFAIK we haven't set up a webserver for this domain, I imagine we can do 
this later on (probably using gitpubsub too in another "api" branch).



On 23/02/18 08:19, Antonio 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




Reply via email to