Hi all,
Please see https://github.com/apache/incubator-netbeans-website/pull/97
with the netbeans.org tutorials/trails automatically transformed to
asciidoc. This is still a work in progress.
Main features:
- 3rd donation tutorials automatically converted to Asciidoc with
incubator-netbeans-tools
- This is, we removed netbeans.org specific HTML stuff.
- Copied images automatically in a 'images' subdir near the documents.
- Added syntax highlighting support for different languages (also wiki
pages).
- Files are stored in the same locations as in netbeans.org, to ease
migration (i.e., kb/docs/, kb/docs/java, etc.)
Tutorials are _NOT_ linked from the home page, this is, there's no link
from the website to the tutorials as of yet: users won't be able to
navigate to the tutorials.
When/if merged, we will have to navigate directly to a tutorial or to
http://netbeans.apache.org/kb or to http://netbeans.apache.org/kb/docs/
The idea is to decide which tutorials we're linking from the web. For
instance, we may not want to link to C/C++ tutorials yet (because we
don't support it yet), but we may want to link to PHP tutorials.
So the basic plan is to:
- Decide which subdirectories we'll link from the main web.
- Manual fine-tuning of content (missing images, removing of manual
table of contents, etc.).
I'll be offline most of the day today, but will try to set up a plan in
the coming days as time permits.
Kind regards,
Antonio
El 05/01/2019 a las 10:51, Geertjan Wielenga escribió:
It seems they're in your GitHub, right now, i.e., github.com/vieiro:
https://github.com/vieiro/incubator-netbeans-website/blob/feature/third-donation-tutorials/netbeans.apache.org/src/content/kb/docs/java/quickstart.asciidoc
Is this correct, right now, or is there a link on the Apache NetBeans
GitHubs somewhere.
Thanks,
Gj
On Sun, Dec 30, 2018 at 11:20 PM Antonio <[email protected]> wrote:
Good plan! Thanks, Geertjan!
El 30/12/2018 a las 12:24, Geertjan Wielenga escribió:
Great and thanks for all the work!
From my point of view, it would be simplest if you'd create a list of
tasks
on the Wiki, each task being an issue so that we can track via JIRA.
So far, it seems to me that the best approach is to simply take the lead
and put those tasks out there as a starting point, and then others will
take it from there. A discussion that is too open is not going to get too
many responses, it seems so far.
From my end, I've been working on netbeans.org -- especially the front
page
where every link AFAIK now point to netbeans.apache.org. Since a few
minutes, the netbeans.org/downloads page redirects to the Apache
NetBeans
download page.
In short, until we have all the documentation that is on netbeans.org
safely housed and structured at Apache, and we have redirects etc in
place,
netbeans.org will as far as possible simply have all/most of its links
redirect to netbeans.apache.org.
Gj
On Fri, Dec 28, 2018 at 7:35 PM Antonio <[email protected]> wrote:
Hi all,
As you know the current https://netbeans.apache.org was launched about
one year ago and has gone through different enhancements.
During this year we've added some wiki pages, some content, our download
pages are compliant with Apache requirements and we're also compliant
with all Apache Whimsy requirements [1].
Before starting integrating the tutorials [2] and before leaving the
incubator we may want to prepare some enhancements. These may range from
look and feel enhancements (banners, images, icons, typography
enhancements, etc.) to content enhancements (sidebars, banners, etc.),
or some repository enhancements (removing the 'bits.netbeans.org'
directory, for instance, as this is now handled elsewhere) or tooling
enhancements.
What do you think could be improved? Are there any volunteers for the
look and feel enhancements? Do we want to start a "web design contest"
much like the "NetBeans Logo Contest" we did for our logo? Do we want to
host a NetBeans blog there as well?
Ideas and request for enhancements would be most welcome. Let's
brainstorm.
Thanks in advance,
Antonio
[1]
https://whimsy.apache.org/pods/project/netbeans
[2]
https://github.com/vieiro/incubator-netbeans-website/tree/feature/third-donation-tutorials/netbeans.apache.org/src/content/kb/docs
---------------------------------------------------------------------
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
---------------------------------------------------------------------
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
---------------------------------------------------------------------
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
