I created a new JIRA (JSPWIKI-1119) to track my intended first of
several changes to the wiki, in which I would like to address the
installation advice.
Your previous advice (below) is still valid. jspwiki-site contains some
of the content, but not the pages of interest to me at this time.
I wanted to work in a "top down" direction, so my first task seemed to
be trivial. I believe it should be very easy for new visitors to make
progress. It is easy to find the "Downloads" page, but not so easy to
find the "Getting Started" page. (Of course, you can search for it - but
that assumes you already know the name, or some unique content, of the
page.)
I would like to put a link to "getting Started" on the Main page left
menu, and add it with some extra text to the Downloads page.
I successfully logged on to the new Apache Infra LDAP-enabled JIRA
system with my apache developer credentials to create my JIRA, so that
was encouraging.
Next, I logged on to the JSPWiki wiki itself, which confusingly is not
LDAP enabled (my own personal jspwiki is!) and so I have to use a
different set of credentials.
I loaded the three pages of immediate interest, but the edit option is
greyed out and I see a "no entry" sign when I move my mouse over it.
My roles are "all" and "authenticated", but my userid does not appear in
any of the groups that I can see.
Because I don't have the source for the pages, I can't easily send you
diffs to apply for me.
Anyone could make the high-level changes for me. However, my plan after
this initial change is for fairly major surgery on the "Getting Started"
page.
It needs updating to reflect java8 and tomcat8, as well as some advice
about systemd for linux users. I feel the "Getting Started" page should
be trimmed down a lot, but then have it link to several separate pages
relevant to different classes of users (e.g. Quick Evaluation, Simple,
Persistent External Content, Production, Customisation).
I would raise a separate JIRA to track my work on the "Getting Started"
changes.
Would it make sense to authorise my JSPWiki userid (case sensitive
BrianB) for online updates to the production wiki content? After all, I
guess it uses the VersioningFileprovider and so wouldn't be too
difficult to back out my changes if someone doesn't like them.
As you can tell from the elapsed time associated with this thread, I
struggle to find time to contribute to the project. However, I am
actively working (part-time) on my own tomcat and JSPWiki upgrades, so
it is relatively easy for me to share my experiences (both painful and
successful).
Regards,
Brian
On 6/5/19 6:31 am, Juan Pablo Santos RodrÃguez wrote:
Hi Brian,
pages served under jspwiki.apache.org are built using the jbake branch at
https://github.com/apache/jspwiki-site/ That's an static site, which serves
mainly
for two things:
1.- serve javadocs
2.- as a backup site of jspwiki-wiki.apache.org
jspwiki-wiki.apache.org is a JSPWiki application that we use as
documentation of JSPWiki, and as such their pages are stored (and backed
up, but that's
another story) on VM provided by ASF Infra. IIRC, you can set up your
account there and edit where appropiate. There are several people which
look from time to
time to edit whatever necessary in order to avoid spam and have the
documentation focused and in order. If you want to propose a change on a
protected page
perhaps the best way is to discuss the change here at dev@j.a.o and it will
be eventually carried over.
As a side note, jspwiki.a.o, as a backup site, contains the minimum pages
to run the project page (mailing lists, news, where's the source code, etc.)
HTH,
juan pablo
On Thu, May 2, 2019 at 8:46 AM Brian Burch <br...@pingtoo.com> wrote:
I'm feeling pretty dumb today. After several weeks messing around with
M3 and my plugin, I decided to do a clean install by following the
extensive notes I made the first time around, but skipping all the dead
ends. My intention was to suggest some changes to the JSPWiki wiki
reflecting the gotchas I encountered before I did anything towards
deploying my own code.
I've done lots of searches, and scraped through my old emails, but
nothing helped me. I found my question (with the title above) to the Dev
list almost a year ago, which was not answered directly. Juan Pablo
implemented my suggested changes at the time, which were simple text
blocks in an email. I hoped to make it easier for everyone this time,
but so far I've failed miserably.
In my searches I stumbled across this page:
http://jspwiki.apache.org/development/edit_website.html
.. but it didn't tell me enough to get to the "static source" of the
pages I would like to be changed.
Hidden under a hyperlink to "This Repository" I discovered:
https://github.com/apache/jspwiki-site/
I separately cloned the trunk, as well as the jbake and asf-site
branches. It is true these directory trees contain a content
subdirectory, and even the source for a lot of pages (including,
ironically, the edit_website page), but not the page I was most
interested in having changed, which is:
https://jspwiki-wiki.apache.org/Wiki.jsp?page=Getting%20Started
I submitted several diffs to the apacheds project last year, so I
checked the repository for that web site (wiki)... all the relevant page
sources were where I expected to find them, with names I expected.
I'm baffled and find myself having to ask for help yet again. Clearly, I
am missing a vital concept at the moment. Could anyone help by giving me
simple directions to obtain the source to the Getting Started page, please?
Apologies!
Brian
