i found it. system environment variables starting with "jspwiki_" are merged within the settings.
On Sat, Mar 30, 2024 at 9:58 AM Alex O'Ree <alexo...@apache.org> wrote: > 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? >> > >> > > > > > >> >> > >> > > > > > > >> > >> > > > > >> > >> > > > >> > >> > > >> > >> >> > > >> > >> >
