Didn’t test the repo yet but I will, because I would like to be part of the refactoring of the page or rebuild etc. but I hope that we will use SCSS or LESS, because it will bring us a lot of benefits. If not I can make a PR to Change the infra from plain CSS to SCSS. But if it is already there, ignore this mail.
Gesendet von Mail für Windows 10 Von: Antonio Gesendet: Sonntag, 10. Dezember 2017 19:20 An: dev@netbeans.incubator.apache.org Betreff: Re: NetBeans Website Conversion, Plan, and Call for Help So I got, for example, community/index.html and created a plain community/index.html.yml (see below). After baking I got a "baked" index.html with a nice header and footer, but also with a "<html><head>...</html>" inside. I imagine we'll have to go through all those "*.html" files (5504 to be exact) and clean then up somehow. One way to do this is by converting those html files to asciidoc equivalents. This shouldn't be too difficult using the gumbo parser, for instance [1], and some python and/or lua hacking. With a basic asciidoc metadata section for jbake in each file that we can then manually fine-tune. The conversion of the these html files could translate all src/content/**.html to src/asciidoc/**.adoc counterparts. We will then have to fine-tune the asciidoc content and the metadata. Another option would be to use the gumbo-parser to extract the contents of the "<body>" tag of each one of those 5504 html files, transforming those "src/content/**.html" to a "src/pruned-content/**.html" counterparts (and some **.html.yml basic companions) without the "<html>" and "<head>" parts, and try to pretty-print an html equivalent in a "src/pruned-content" directory. I would prefer the first option. Having the website in asciidoc would make it easier to generate PDF and/or EPUB from the pages. Let me know if you want me to try out any of these. Cheers, Antonio [1] https://github.com/google/gumbo-parser ---- The yml I used for community/index.html type: page status: published title: Apache NetBeans description: Oracle Proposes NetBeans As Apache Incubator Project summary: Oracle Proposes NetBeans As Apache Incubator Project tags: - news - apache El 10/12/17 a las 18:40, Geertjan Wielenga escribió: > OK that’s good too. The other one was there, but if not anymore, whichever > yml is there as an example would be best to use as a starting point. > Ideally Wade would jump in here to advise. > > Gj > > On Sun, 10 Dec 2017 at 18:38, Antonio <anto...@vieiro.net> wrote: > >> Do you mean >> 3. See kb/docs/java/quickstart.html and quickstart.yml >> At >> https://cwiki.apache.org/confluence/display/NETBEANS/JBake-based+solution >> ? >> >> I can find "quickstart.html", but "quickstart.yml" is gone. >> >> Anyway I found >> >> - src/content/community/apache-incubator.html >> and >> - src/content/community/apache-incubator.html.yml >> >> >> >> >> El 10/12/17 a las 18:31, Geertjan Wielenga escribió: >>> Step 3 in the Exploring section of the URL I provided earlier in this >>> thread. >>> >>> Gj >>> >>> On Sunday, December 10, 2017, Antonio <anto...@vieiro.net> wrote: >>> >>>> Hi Geertjan, >>>> >>>> What's this "the Java SE Quick Start Guide" link you're talking about? >> I'm >>>> unable to find it. >>>> >>>> Thanks, >>>> Antonio >>>> >>>> El 08/12/17 a las 17:59, Geertjan Wielenga escribió: >>>> >>>>> Yes exactly. And the Jbake infrastructure is already there with the >> start >>>>> of templating in place as well, see the link I sent earlier re the >> Java SE >>>>> Quick Start Guide which is set up already with a template to get things >>>>> going as a starting point. Movement on this is needed and really great >>>>> you’re picking this up. >>>>> >>>>> Gj >>>>> >>>>> On Fri, 8 Dec 2017 at 17:56, Antonio <anto...@vieiro.net> wrote: >>>>> >>>>> Hi all, >>>>>> >>>>>> So I have some time to spend here, and I was thinking it would be a >>>>>> great idea to explain what I understand so you can tell me if I'm >>>>>> understanding things right. Please see the small image attached. >>>>>> >>>>>> From the WIKI and Wade's repository what I understand is that >> we'll be >>>>>> working against Wade's repository, fine-tuning the future NetBeans >>>>>> website. Once done we'll be able to host a website repository under >> the >>>>>> Apache umbrella. >>>>>> >>>>>> So we'll need a basic website layout, that should look like the >> current >>>>>> one to avoid url mismatches, I imagine. And we'll need to work out >> some >>>>>> jbake+groovy templates to polish the content until it fits the >> directory >>>>>> layout. >>>>>> >>>>>> Am I getting it right? >>>>>> >>>>>> Thanks, >>>>>> Antonio >>>>>> >>>>>> >>>>>> >>>>>> On 03/12/17 05:07, Wade Chandler wrote: >>>>>> >>>>>>> All, >>>>>>> >>>>>>> I will try to keep this short as one can read details here >>>>>>> >>>>>> https://cwiki.apache.org/confluence/display/NETBEANS/New+ >>>>>> NetBeans+Web+Site+Planning >>>>>> < >>>>>> https://cwiki.apache.org/confluence/display/NETBEANS/New+ >>>>>> NetBeans+Web+Site+Planning >>>>>> >>>>>>> >>>>>>> >>>>>>> I’m still working on the site planning page, but I think there is >> enough >>>>>>> >>>>>> there to get started and have others chip in, and please feel free to >> add >>>>>> sections I’m missing, and feel free to ask any questions, and I or >>>>>> someone >>>>>> else will try to address them. I would also like to get a Kanban board >>>>>> setup for this, and will try to get that done soon. Please ask for >> more >>>>>> details on the plan page or let me know what else might be useful for >> us >>>>>> to >>>>>> organize. >>>>>> >>>>>>> >>>>>>> Also, please fully read the docs here >>>>>>> >>>>>> https://github.com/wadechandler/netbeans-static-site < >>>>>> https://github.com/wadechandler/netbeans-static-site> and if >> anything is >>>>>> missing or needs to be more clear, then please add an issue or send an >>>>>> email, and I will try to clear it up, and we can work through it. >>>>>> >>>>>>> >>>>>>> There is a lot to do to convert the NetBeans website over to Apache. >>>>>>> >>>>>> Beyond just the static content, we have these other dynamic aspects >>>>>> which I >>>>>> have yet to be able to devote any real thought. >>>>>> >>>>>>> >>>>>>> I’m currently working on scripting the static content to fit the SSG, >>>>>>> >>>>>> and that is a pretty big task, and I have more to do. Any help >> related to >>>>>> the areas I have not yet been able to touch is more than welcome. >>>>>> >>>>>>> >>>>>>> You’ll notice the page says we're using the repository linked above >> for >>>>>>> >>>>>> now, and that its only purpose is to cleanup the content, and shrink >> it, >>>>>> before moving it over to the incubator site repository; imagine how >> large >>>>>> that history will be if all the cruft is left in place. Anyways, it is >>>>>> definitely temporary, and then will be pushed to the Apache >> repository. >>>>>> >>>>>>> >>>>>>> If there is an area anyone would like to jump in on, feel free to put >>>>>>> >>>>>> your name beside an area in the Wiki and/or assign some issues to >>>>>> yourself. >>>>>> I’m taking Thur and Fri off through the end of the year, and plan to >> work >>>>>> diligently on the content conversion during that time, and hopefully >>>>>> narrow >>>>>> the plan more too. >>>>>> >>>>>>> >>>>>>> Thank you much! >>>>>>> >>>>>>> Wade >>>>>>> >>>>>>> >>>>>>> >>>>>>> >>>>>> >>>>> >>> >> >
