or environment variable support, what's the syntax for the config file?
filed as https://issues.apache.org/jira/browse/JSPWIKI-1188
On Sat, Mar 30, 2024 at 8:00 AM Juan Pablo Santos Rodríguez <
juanpablo.san...@gmail.com> wrote:
> Hi Alex,
>
> IIRC, there isn't support for that, would you mind opening jira ticket with
> this, so it can be tackled later on?
>
> As an alternative, you can provide the properties as environment variables,
> where you can compose them based on other env. variables.
>
>
> HTH,
> juan pablo
>
> El jue, 28 mar 2024, 18:15, Alex O'Ree <alexo...@apache.org> escribió:
>
> > For the jsp wiki properties file, is there a syntax for referencing a
> > system property?
> > for example, i want to store wiki content in ${catalina.base}/wiki would
> > should resolve to something like c:\tomcat\wiki as a sibling directory to
> > conf, webapps, bin, etc
> >
> > I don't particularly want to put a full path in the config file
> >
> > On Wed, Mar 20, 2024 at 7:33 PM Alex O'Ree <alexo...@apache.org> wrote:
> >
> > > Thanks for the info
> > >
> > > On Wed, Mar 20, 2024, 6:49 PM Juan Pablo Santos Rodríguez <
> > > juanpablo.san...@gmail.com> wrote:
> > >
> > >> Hi!
> > >>
> > >> regarding tomcat/lib, it's just a place on classpath outside the
> > >> jspwiki war. that way you can upgrade your JSPWiki version without
> > >> needing any war surgery. But really, any place on classpath is fine to
> > >> get your jspwiki-custom.properties file read,
> > >>
> > >> As for themes, JSPWiki has the notion of "templates", a group of JSP
> > >> files that render JSPWiki appereance. There is a default template, and
> > >> there are some JSP files to be expected on your template; if they
> > >> aren't found, they're read from the default template. Tipically you
> > >> provide some styles on customheader.jsp (or something like that, don't
> > >> recall the exact name now and don't have the code at hand), and
> > >> usually that's enough to customize the overall appeareance, although
> > >> you can completely modify the UI.
> > >>
> > >> As for the default template, it supports changing appearance
> > >> (light/dark), but also "themes", f.ex., Dark [#1] or clean blue [#2]
> > >> themes. They're another way to change (overall) styling, but they
> > >> don't require a property on your jspwiki-custom file. Search for theme
> > >> at jspwiki-wiki.a.o and you'll get some more info and additional
> > >> themes there.
> > >>
> > >>
> > >> HTH,
> > >> juan pablo
> > >>
> > >> [#1] https://jspwiki-wiki.apache.org/Wiki.jsp?page=Dark%20Theme
> > >> [#2]
> https://jspwiki-wiki.apache.org/Wiki.jsp?page=Clean%20Blue%20Theme
> > >>
> > >> On Mon, Mar 18, 2024 at 1:43 AM Alex O'Ree <alexo...@apache.org>
> wrote:
> > >> >
> > >> > great info, thanks
> > >> >
> > >> > is there a reason for using the tomcat/lib folder for storing config
> > >> file?
> > >> > I feel like it should be in the war/WEB-INF/classes location
> instead.
> > >> >
> > >> > i see that there's different themes available, but it's not clear to
> > use
> > >> > them within the webapp beside light/dark mode. The docs for changing
> > >> themes
> > >> > doesn't seem to correlate with the latest version. Ref
> > >> > https://jspwiki-wiki.apache.org/Wiki.jsp?page=CustomUserPreferences
> > >> >
> > >> > On Sun, Mar 17, 2024 at 7:06 PM Juan Pablo Santos Rodríguez <
> > >> > juanpablo.san...@gmail.com> wrote:
> > >> >
> > >> > > Hi!
> > >> > >
> > >> > > Regarding using the database, yup, It doesn't matter, your
> instances
> > >> should
> > >> > > share db, wiki working dir and cache. The important bit is the
> > >> working dir,
> > >> > > there's were the index files are.
> > >> > >
> > >> > > Regarding the cache, latest master brings support for custom
> events
> > >> > > listeners [#1], which should be the entry point you're looking
> for.
> > >> Bear on
> > >> > > mind that you'll have to code it. And it'll be GA on upcoming
> > 2.12.2.
> > >> > >
> > >> > > Also, Ehcache can be configured to have a shared cache, using a
> > >> multicast
> > >> > > address, so perhaps that's easier to set upthan going through the
> > >> messaging
> > >> > > route?
> > >> > >
> > >> > >
> > >> > > Best regards,
> > >> > > juan pablo
> > >> > >
> > >> > >
> > >> > >
> > >> > > [#1]
> > >> > >
> > >> > >
> > >>
> >
> https://jspwiki-wiki.apache.org/Wiki.jsp?page=HowToWriteACustomWikiEventListener
> > >> > >
> > >> > > El dom, 17 mar 2024, 23:31, Alex O'Ree <spyhunte...@gmail.com>
> > >> escribió:
> > >> > >
> > >> > > > > they should be possible as long as you shared your "wiki work
> > dir"
> > >> > > >
> > >> > > > Is this true, even when a database storage solution?
> > >> > > >
> > >> > > > > Also, by default there's a caching layer in front of the file
> > >> system
> > >> > > > access to pages
> > >> > > > and attachments, ehcache based.
> > >> > > >
> > >> > > > Is there perhaps a server side API that i can use to detect a
> > >> change?
> > >> > > > And to trigger the cache invalidation?
> > >> > > > I have a kafka setup in the environment and...in theory...if i
> can
> > >> detect
> > >> > > > the change, i can send a kafka topic message trigger the
> > >> invalidation for
> > >> > > > all of the instances
> > >> > > >
> > >> > > >
> > >> > > > On Sun, Mar 17, 2024 at 5:43 PM Juan Pablo Santos Rodríguez <
> > >> > > > juanpablo.san...@gmail.com> wrote:
> > >> > > >
> > >> > > > > Hi Alex!
> > >> > > > >
> > >> > > > > regarding rolling upgrades / load balancing, they should be
> > >> possible
> > >> > > > > as long as you shared your "wiki work dir" (containing f.ex.,
> > >> lucene
> > >> > > > > indexes) and your wiki pages/attachment filesystem. Also, by
> > >> default
> > >> > > > > there's a caching layer in front of the file system access to
> > >> pages
> > >> > > > > and attachments, ehcache based. That should be tuned too in
> > order
> > >> to
> > >> > > > > share the cache among your wiki instances.
> > >> > > > >
> > >> > > > > As for the wiki installation, the wiki page dir you note on
> the
> > >> > > > > installation is the path were the wiki pages should be
> > extracted.
> > >> I
> > >> > > > > don't have the installation page on my head now, so perhaps
> the
> > >> > > > > behaviour is different.. Also, I noticed you opened a ticket a
> > few
> > >> > > > > days ago regarding installation, so there's also that (I'll
> try
> > to
> > >> > > > > look at it thie week btw).
> > >> > > > >
> > >> > > > > Last, regarding container based authentication, it's
> definitely
> > >> > > > > possible. We have some integration tests [#2] that run through
> > >> several
> > >> > > > > JSPWiki instances. The "-cma-" ones are those configured to
> use
> > >> > > > > container managed authentication.
> > >> > > > >
> > >> > > > >
> > >> > > > > HTH,
> > >> > > > > juan pablo
> > >> > > > >
> > >> > > > > [#2]
> > >> https://github.com/apache/jspwiki/tree/master/jspwiki-it-tests
> > >> > > > >
> > >> > > > > On Sun, Mar 17, 2024 at 9:35 PM Alex O'Ree <
> alexo...@apache.org
> > >
> > >> > > wrote:
> > >> > > > > >
> > >> > > > > > I think that my issue was during installation, the default
> > >> pages did
> > >> > > > not
> > >> > > > > > install, so i left with a blank wiki. I checked out the
> > sources
> > >> and
> > >> > > > > copied
> > >> > > > > > the default wiki page set and now things are a bit more put
> > >> together
> > >> > > > and
> > >> > > > > > featureful.
> > >> > > > > >
> > >> > > > > > is there a way to use servlet container based authentication
> > or
> > >> just
> > >> > > > use
> > >> > > > > > the container provided servlet request user principle?
> > >> > > > > >
> > >> > > > > >
> > >> > > > > > On Sun, Mar 17, 2024 at 10:46 AM Alex O'Ree <
> > >> alexo...@apache.org>
> > >> > > > wrote:
> > >> > > > > >
> > >> > > > > > > thanks for the info. looks like plugin installation is
> more
> > >> > > developer
> > >> > > > > > > oriented, not really an easy administrative task. i was
> > >> hoping for
> > >> > > > > > > something like a jenkins plugin setup where it's a one
> click
> > >> > > install
> > >> > > > > type
> > >> > > > > > > of thing. not really a problem.
> > >> > > > > > >
> > >> > > > > > > using file system based storage (or database), and there's
> > >> more
> > >> > > than
> > >> > > > > one
> > >> > > > > > > instance of jsp wiki, say for rolling upgrades or load
> > >> balancing,
> > >> > > is
> > >> > > > > there
> > >> > > > > > > a way to notify other instances of changed content and/or
> > >> index
> > >> > > needs
> > >> > > > > to be
> > >> > > > > > > updated?
> > >> > > > > > >
> > >> > > > > > > On Tue, Mar 12, 2024 at 3:38 PM Juan Pablo Santos
> Rodríguez
> > <
> > >> > > > > > > juanpablo.san...@gmail.com> wrote:
> > >> > > > > > >
> > >> > > > > > >> Hi Alex!
> > >> > > > > > >>
> > >> > > > > > >> thanks for your interest in JSPWiki! :-) As for your
> > >> questions:
> > >> > > > > > >>
> > >> > > > > > >> Are there any administrative capabilities? like pages to
> > see
> > >> how
> > >> > > > much
> > >> > > > > > >> stuff exists in the wiki?
> > >> > > > > > >> for the latter, that can be accomplished via plugin [#1].
> > >> IIRC,
> > >> > > The
> > >> > > > > > >> default set of wiki pages contains pages for page index,
> > >> recent
> > >> > > and
> > >> > > > > > >> changes / full history and a system info page with a some
> > >> more
> > >> > > wiki
> > >> > > > > > >> information. You can see all of them at
> > >> jspwiki-wiki.apache.org,
> > >> > > on
> > >> > > > > > >> the left menu, inside the special pages box. Don't know
> if
> > >> you're
> > >> > > > > > >> looking for something else though
> > >> > > > > > >>
> > >> > > > > > >> Ability to preload content? backup/restore?
> > >> > > > > > >> Pages/Attachment by default are stored on files inside a
> > >> > > directory.
> > >> > > > > > >> The initial page load consists on unzipping a file
> inside a
> > >> > > folder,
> > >> > > > so
> > >> > > > > > >> nothing stops you from putting there more pages. For new
> > >> pages to
> > >> > > be
> > >> > > > > > >> picked up you should restart your jspwiki instance, so
> they
> > >> get
> > >> > > > picked
> > >> > > > > > >> up by the indexer. There aren't any in-built capabilities
> > to
> > >> > > > > > >> import/export pages or backup/restore, you have to take
> > care
> > >> of
> > >> > > that
> > >> > > > > > >> outside JSPWiki. Also, I've said pages are stored on disk
> > >> (the
> > >> > > page
> > >> > > > > > >> and attachment providers), but you can provide your own
> > >> > > > > > >> page/attachment provider implementation
> > >> > > > > > >>
> > >> > > > > > >> User management and permissions setup?
> > >> > > > > > >> Please see [#2] all related to Identity management,
> groups,
> > >> ACLs
> > >> > > > > > >> (application-wide or per page), authentication, etc.
> > >> > > > > > >>
> > >> > > > > > >> I'd also add the things that I like most from JSPWiki:
> > >> > > > > > >> * very, very easy to use and setup
> > >> > > > > > >> * almost every moving part of JSPWiki is customisable and
> > >> can be
> > >> > > > > > >> replaced with another implementation, 3rd party or not (2
> > >> page
> > >> > > > > > >> providers, 3 search indexers, two wiki syntaxis, plugins,
> > >> filters)
> > >> > > > > > >> * deployment options (war, portable binaries, docker
> > images)
> > >> > > > > > >> * comprehensive security options
> > >> > > > > > >>
> > >> > > > > > >>
> > >> > > > > > >> HTH,
> > >> > > > > > >> juan pablo
> > >> > > > > > >>
> > >> > > > > > >>
> > >> > > > > > >> [#1]
> > >> > > https://jspwiki-wiki.apache.org/Wiki.jsp?page=Category.Plugins
> > >> > > > > > >> [#2 <
> > >> > > > >
> > https://jspwiki-wiki.apache.org/Wiki.jsp?page=Category.Plugins[#2
> > >> >]
> > >> > > > > > >>
> > >> https://jspwiki-wiki.apache.org/Wiki.jsp?page=Wiki.Admin.Security
> > >> > > > > > >>
> > >> > > > > > >> On Tue, Mar 12, 2024 at 12:14 AM Alex O'Ree <
> > >> alexo...@apache.org>
> > >> > > > > wrote:
> > >> > > > > > >> >
> > >> > > > > > >> > I'm shopping around for a java based wiki solution.
> I've
> > >> found
> > >> > > > > xwiki and
> > >> > > > > > >> > seems pretty capable, but i've always been a fan of asf
> > >> projects
> > >> > > > so
> > >> > > > > i'm
> > >> > > > > > >> > digging deep into jspwiki.
> > >> > > > > > >> >
> > >> > > > > > >> > Are there any administrative capabilities? like pages
> to
> > >> see how
> > >> > > > > much
> > >> > > > > > >> stuff
> > >> > > > > > >> > exists in the wiki?
> > >> > > > > > >> > Ability to preload content? backup/restore?
> > >> > > > > > >> > User management and permissions setup?
> > >> > > > > > >>
> > >> > > > > > >
> > >> > > > >
> > >> > > >
> > >> > >
> > >>
> > >
> >
>
