Almost-minimal filesystem based blog.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

98 lines
3.7 KiB

  1. NAME
  2. Wala.pm - easy minimalist wiki
  3. SYNOPSIS
  4. As a standalone wiki app:
  5. #!/usr/bin/perl
  6. use Wala;
  7. my $w = Wala->new;
  8. $w->run;
  9. Pulling content into other scripts:
  10. $text = $w->print_page('SandBox');
  11. DESCRIPTION
  12. This is a Wala, which is a derivation of a wiki that incorporates
  13. appending text directly to pages, turning a wiki into something more
  14. like a forum while retaining all the wonderful full-page editing
  15. features of a wiki.
  16. INSTALLATION
  17. This script is a self-contained package, which makes the code easy to
  18. test. To actually use it as a wala, create a script named "wala.pl" in
  19. the same directory, containing the following three lines:
  20. #!/usr/bin/perl
  21. use Wala;
  22. my $w = Wala->new();
  23. $w->run;
  24. You can experiment with the wala by use'ing it and calling its functions
  25. without calling "run". By default, required directories and files should
  26. be created as needed, but you can visit wala.pl?setup in your browser,
  27. or call "setup()" from a script at any time.
  28. CONFIGURATION
  29. You can set options directly from the calling script, like so:
  30. #!/usr/bin/perl
  31. use Wala;
  32. my $w = Wala->new(
  33. RecentChangesMaxLines => 50, # Max lines to display in RecentChanges
  34. DefaultUserName => 'Anonymous', # Default user name
  35. StyleSheet => 'wala.css', # URL of style sheet
  36. DefaultPageText => "Write something.\n",
  37. CookieSurvivalDays => 90, # Number of days for cookies to remain
  38. RootDir => '.', # No trailing slash, please
  39. HomePage => 'HomePage', # Name of default page
  40. TimeZone => 'UTC', # Currently just a string to display
  41. TitleString => 'wala::', # Display before page names in titles
  42. ScriptName => 'wala.pl', # substr( $0, rindex( $0, "/" ) + 1 );
  43. ShowSearchlinks => 1, # Display "see also" box on pages
  44. CheckSetup => 1, # Check for setup files every time
  45. UseCache => 0, # Don't use caching behavior
  46. );
  47. $w->run;
  48. FEEDS
  49. Feeds are practically a requirement these days. While it wouldn't be the
  50. hardest thing in the world to roll my own Atom or RSS within Wala.pm, it
  51. was much less painful to look to CPAN, which offers
  52. XML::Atom::SimpleFeed.
  53. I've included a simple wala_feed.pl, which relies on the aforementioned
  54. module. It shouldn't be too hard to customize.
  55. If you do something along the lines of:
  56. FeedURL => 'http://p1k3.com/wala/wala_feed.pl',
  57. in your configuration, Wala.pm will link to your feed in page headers so
  58. that browsers like Firefox will auto-discover it.
  59. LICENSE
  60. No warranty of any kind is made regarding this software's fitness or
  61. suitability for any purpose. The authors explicitly disclaim any
  62. liability or responsibility for the results of its use.
  63. This software is dedicated to the public domain. In any jurisdiction
  64. where a dedication to the public domain is not permitted by law, the
  65. authors grant you a perpetual, non-exclusive license to modify and/or
  66. redistribute the software in any medium, world-wide, forever and ever.
  67. Though there is no legal requirement, credit would be appreciated.
  68. AUTHORS
  69. Wala was originally written by Brent P. Newhall. This version contains
  70. substantial modifications by Brennen Bearnes; following Brent's lead,
  71. all changes are placed in the public domain. Egregious bugs are probably
  72. Brennen's fault.
  73. REVISION
  74. Brennen's version, branched from Brent's at 1.1.4
  75. Last updated Thu Jun 7 13:45:31 PDT 2007