You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jspwiki.apache.org by Brian Burch <br...@pingtoo.com> on 2019/10/20 05:44:11 UTC
Re: How to update the JSPWiki Wiki (RE-revisited!)
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
>>
>
Re: How to update the JSPWiki Wiki (RE-revisited!)
Posted by Brian Burch <br...@pingtoo.com>.
On 4/11/19 2:27 am, Dirk Frederickx wrote:
> Hi Brian,
>
> Txs for being persistent !
I /hate/ walking away from something that ought to work, even if I can't
figure out how to fix it. I am pleased you don't think I was making too
much of a fuss.
> Apparently I made an error when building the new Gardener group.
>
> Adding members to the group needs to be done by separating the names with a
> carriage return. (as indicated in the text)
>
> However, I added the members by separating them with a comma.
> Actually, I copied the Admin group when creating the Gardener group. (the
> list contains COMMA's)
> Unfortunately, JSPWiki doesn't throw an error for this incorrect entry.
>
> I did fix the group now.
> Please try again, you should be ok to edit pages with the GARDENER ACL.
> Also you should be able to modify the GARDENER group.
That worked perfectly, Dirk!
After logging on I displayed my profile and was pleased to see my Group
membership had changed from none to Gardener.
I then moused over the Edit option on the Getting Started page without
seeing the no entry sign. I went into the page editor and then cancelled
- simply because I am not sufficiently prepared to begin the
page-splitting work.
I am satisfied that I can now do the work I intended, so "the ball is
back in my court"!
Well done!
Brian
> Best regards,
> dirk
>
>
> On Sun, Nov 3, 2019 at 2:59 AM Brian Burch <br...@pingtoo.com> wrote:
>
>> On 30/10/19 7:29 am, Dirk Frederickx wrote:
>>> Hi Brian,
>>>
>>>>> snippet
>>>
>>>> However, I am puzzled by the fact that "Edit" on both these pages
>>>> (between View and More) is still greyed-out. When I move my mouse over
>>>> the "Edit" widget, google chrome displays a No Entry sign.
>>>>
>>>> How am I supposed to edit the Getting Started page? Am I just being
>> stupid?
>>>>
>>>> As you are a member of the Gardener group, you should be able to edit
>>> this page. (apparently this is not the case)
>>> Make sure you are (still) logged in when trying to Edit the page.
>>> If you still can't, you may want to check whether you are member of the
>>> Gardener group. (maybe the username is incorrectly spelled?)
>>
>> Thanks for your patience, Dirk.
>>
>> I went through my investigation very carefully, but nothing changed.
>> However, I have discovered what might be an important clue.
>>
>> 1. I successfully logged on the the wiki with my case-sensitive userid
>> and current password.
>>
>> 2. Under my user details (top right corner) I displayed the groups...
>> BrianB is definitely the last entry in the Gardener group and you
>> performed the update.
>>
>> 3. The page source for Getting Started has [ALLOW edit Gardener] as
>> expected.
>>
>> 4. When I display my own user profile I see my Roles are "All,
>> authenticated".
>>
>> 5. However, my Groups field displays as "(none)". I cannot edit this
>> field and suspect it should contain the value Gardener.
>>
>> 6. With my ultra-paranoid hat on, I cleared my cookie on the Profile
>> page, then logged off. When I logged back on NOTHING had changed
>> (profile/group and edit no-entry sign).
>>
>> 7. I even tried it all again with firefox (instead of chrome), but
>> everything was exactly the same.
>>
>> What do you think?
>>
>>
>> If it would help I could send you my password via a side channel and you
>> could try yourself.. I don't think it would be helpful to test with a
>> different user name.
>>
>> Brian
>>
>>> As a member of the Gardener group, do I have the right to create new
>>>> pages on the production wiki?
>>>>
>>>> Yes, you should be able create new pages.
>>> If you do so, and want to restrict the EDIT permission, use the ALLOW
>>> plugin.
>>>
>>>
>>> Good luck,
>>> dirk
>>>
>>
>>
>
Re: How to update the JSPWiki Wiki (RE-revisited!)
Posted by Dirk Frederickx <di...@gmail.com>.
Hi Brian,
Txs for being persistent !
Apparently I made an error when building the new Gardener group.
Adding members to the group needs to be done by separating the names with a
carriage return. (as indicated in the text)
However, I added the members by separating them with a comma.
Actually, I copied the Admin group when creating the Gardener group. (the
list contains COMMA's)
Unfortunately, JSPWiki doesn't throw an error for this incorrect entry.
I did fix the group now.
Please try again, you should be ok to edit pages with the GARDENER ACL.
Also you should be able to modify the GARDENER group.
Best regards,
dirk
On Sun, Nov 3, 2019 at 2:59 AM Brian Burch <br...@pingtoo.com> wrote:
> On 30/10/19 7:29 am, Dirk Frederickx wrote:
> > Hi Brian,
> >
> >>> snippet
> >
> >> However, I am puzzled by the fact that "Edit" on both these pages
> >> (between View and More) is still greyed-out. When I move my mouse over
> >> the "Edit" widget, google chrome displays a No Entry sign.
> >>
> >> How am I supposed to edit the Getting Started page? Am I just being
> stupid?
> >>
> >> As you are a member of the Gardener group, you should be able to edit
> > this page. (apparently this is not the case)
> > Make sure you are (still) logged in when trying to Edit the page.
> > If you still can't, you may want to check whether you are member of the
> > Gardener group. (maybe the username is incorrectly spelled?)
>
> Thanks for your patience, Dirk.
>
> I went through my investigation very carefully, but nothing changed.
> However, I have discovered what might be an important clue.
>
> 1. I successfully logged on the the wiki with my case-sensitive userid
> and current password.
>
> 2. Under my user details (top right corner) I displayed the groups...
> BrianB is definitely the last entry in the Gardener group and you
> performed the update.
>
> 3. The page source for Getting Started has [ALLOW edit Gardener] as
> expected.
>
> 4. When I display my own user profile I see my Roles are "All,
> authenticated".
>
> 5. However, my Groups field displays as "(none)". I cannot edit this
> field and suspect it should contain the value Gardener.
>
> 6. With my ultra-paranoid hat on, I cleared my cookie on the Profile
> page, then logged off. When I logged back on NOTHING had changed
> (profile/group and edit no-entry sign).
>
> 7. I even tried it all again with firefox (instead of chrome), but
> everything was exactly the same.
>
> What do you think?
>
>
> If it would help I could send you my password via a side channel and you
> could try yourself.. I don't think it would be helpful to test with a
> different user name.
>
> Brian
>
> > As a member of the Gardener group, do I have the right to create new
> >> pages on the production wiki?
> >>
> >> Yes, you should be able create new pages.
> > If you do so, and want to restrict the EDIT permission, use the ALLOW
> > plugin.
> >
> >
> > Good luck,
> > dirk
> >
>
>
Re: How to update the JSPWiki Wiki (RE-revisited!)
Posted by Brian Burch <br...@pingtoo.com>.
On 30/10/19 7:29 am, Dirk Frederickx wrote:
> Hi Brian,
>
>>> snippet
>
>> However, I am puzzled by the fact that "Edit" on both these pages
>> (between View and More) is still greyed-out. When I move my mouse over
>> the "Edit" widget, google chrome displays a No Entry sign.
>>
>> How am I supposed to edit the Getting Started page? Am I just being stupid?
>>
>> As you are a member of the Gardener group, you should be able to edit
> this page. (apparently this is not the case)
> Make sure you are (still) logged in when trying to Edit the page.
> If you still can't, you may want to check whether you are member of the
> Gardener group. (maybe the username is incorrectly spelled?)
Thanks for your patience, Dirk.
I went through my investigation very carefully, but nothing changed.
However, I have discovered what might be an important clue.
1. I successfully logged on the the wiki with my case-sensitive userid
and current password.
2. Under my user details (top right corner) I displayed the groups...
BrianB is definitely the last entry in the Gardener group and you
performed the update.
3. The page source for Getting Started has [ALLOW edit Gardener] as
expected.
4. When I display my own user profile I see my Roles are "All,
authenticated".
5. However, my Groups field displays as "(none)". I cannot edit this
field and suspect it should contain the value Gardener.
6. With my ultra-paranoid hat on, I cleared my cookie on the Profile
page, then logged off. When I logged back on NOTHING had changed
(profile/group and edit no-entry sign).
7. I even tried it all again with firefox (instead of chrome), but
everything was exactly the same.
What do you think?
If it would help I could send you my password via a side channel and you
could try yourself.. I don't think it would be helpful to test with a
different user name.
Brian
> As a member of the Gardener group, do I have the right to create new
>> pages on the production wiki?
>>
>> Yes, you should be able create new pages.
> If you do so, and want to restrict the EDIT permission, use the ALLOW
> plugin.
>
>
> Good luck,
> dirk
>
Re: How to update the JSPWiki Wiki (RE-revisited!)
Posted by Dirk Frederickx <di...@gmail.com>.
Hi Brian,
>>snippet
> However, I am puzzled by the fact that "Edit" on both these pages
> (between View and More) is still greyed-out. When I move my mouse over
> the "Edit" widget, google chrome displays a No Entry sign.
>
> How am I supposed to edit the Getting Started page? Am I just being stupid?
>
> As you are a member of the Gardener group, you should be able to edit
this page. (apparently this is not the case)
Make sure you are (still) logged in when trying to Edit the page.
If you still can't, you may want to check whether you are member of the
Gardener group. (maybe the username is incorrectly spelled?)
As a member of the Gardener group, do I have the right to create new
> pages on the production wiki?
>
> Yes, you should be able create new pages.
If you do so, and want to restrict the EDIT permission, use the ALLOW
plugin.
Good luck,
dirk
Re: How to update the JSPWiki Wiki (RE-revisited!)
Posted by Dirk Frederickx <di...@gmail.com>.
<snippet>
> With my own wiki, which uses LDAP authentication and authorisation, I
> restrict the use of Edit.jsp so it can only be executed by the users
> assigned to the correct role.
>
> Is something like that happening with my failed attempts when accessing
> the JSPWiki wiki non-LDAP configuration?
>
> Just a thought...
>
>
>
No, this is not the case on apache-jspwiki site, which uses the build-in
permission rule mechanism of jspwiki itself.
dirk
Re: How to update the JSPWiki Wiki (RE-revisited!)
Posted by Brian Burch <br...@pingtoo.com>.
On 24/10/19 10:01 am, Brian Burch wrote:
> On 22/10/19 6:09 am, Dirk Frederickx wrote:
>> Hi Brian,
>>
>> I've created a new "Gardener" group on the jspwiki-site; and included
>> user
>> BrianB (and all administrators).
>
<snip/>
>
> However, I am puzzled by the fact that "Edit" on both these pages
> (between View and More) is still greyed-out. When I move my mouse over
> the "Edit" widget, google chrome displays a No Entry sign.
>
> How am I supposed to edit the Getting Started page? Am I just being stupid?
>
With my own wiki, which uses LDAP authentication and authorisation, I
restrict the use of Edit.jsp so it can only be executed by the users
assigned to the correct role.
Is something like that happening with my failed attempts when accessing
the JSPWiki wiki non-LDAP configuration?
Just a thought...
Brian
Re: How to update the JSPWiki Wiki (RE-revisited!)
Posted by Brian Burch <br...@pingtoo.com>.
On 22/10/19 6:09 am, Dirk Frederickx wrote:
> Hi Brian,
>
> I've created a new "Gardener" group on the jspwiki-site; and included user
> BrianB (and all administrators).
Thanks very much, Dirk.
I logged on this morning and saw you have been busy on my behalf.
I quickly confirmed my userid (case sensitive) was on the members list
for the new Gardener group.
I could also see you had added "Getting Started" to the Left Menu on the
Main page, which was all I wanted to achieve. Therefore, I agree there
was no point in assigning [{ALLOW edit Gardener}] to this page source.
I apologise for overlooking the fact that the Left Menu is propagated to
all wiki pages, so I was satisfied there is no need to modify its
editing permission.
> The LeftMenu and the GettingStarted pages are now editable for this group.
I can see the source of these two pages contain [{ALLOW edit Gardener}],
so thank you. I could also confirm the updates were made by you by
inspecting the page change histories.
However, I am puzzled by the fact that "Edit" on both these pages
(between View and More) is still greyed-out. When I move my mouse over
the "Edit" widget, google chrome displays a No Entry sign.
How am I supposed to edit the Getting Started page? Am I just being stupid?
> If you'd like to update other protected pages, please let me know.
As I mentioned before, I prefer an approach that changes Getting Started
to become a summary page, with links off to several new pages, each for
different levels of sophistication.
As a member of the Gardener group, do I have the right to create new
pages on the production wiki?
Thanks for your help,
Brian
>
> BR
> dirk
>
> On Sun, Oct 20, 2019 at 7:45 AM Brian Burch <br...@pingtoo.com> wrote:
>
>> 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
>>>>
>>>
>>
>>
>
Re: How to update the JSPWiki Wiki (RE-revisited!)
Posted by Dirk Frederickx <di...@gmail.com>.
Hi Brian,
I've created a new "Gardener" group on the jspwiki-site; and included user
BrianB (and all administrators).
The LeftMenu and the GettingStarted pages are now editable for this group.
If you'd like to update other protected pages, please let me know.
BR
dirk
On Sun, Oct 20, 2019 at 7:45 AM Brian Burch <br...@pingtoo.com> wrote:
> 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
> >>
> >
>
>