Index: openacs-4/packages/lars-blogger/www/doc/index.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/lars-blogger/www/doc/index.adp,v diff -u -r1.3 -r1.4 --- openacs-4/packages/lars-blogger/www/doc/index.adp 26 Aug 2015 18:03:35 -0000 1.3 +++ openacs-4/packages/lars-blogger/www/doc/index.adp 12 Sep 2016 06:09:45 -0000 1.4 @@ -14,17 +14,17 @@ the instance, and then visit the URL where you mounted it. Now you can add your first blog entry.</p> <h2>Syndicating a blog (putting it on your front page)</h2> -<p>If you want to include a blog as part of another page, that's -pretty simple.</p> -<p>If you're including in an ADP, say:</p> +<p>If you want to include a blog as part of another page, +that's pretty simple.</p> +<p>If you're including in an ADP, say:</p> <blockquote><pre> <include src="/packages/lars-blogger/www/blog" url="/blog"> </pre></blockquote> <p>... for the non-cached version, and ...</p> <blockquote><pre> <%=[lars_blog_get_as_string -url "/blog"]%> </pre></blockquote> -<p>... for the cached version. There shouldn't be any problems +<p>... for the cached version. There shouldn't be any problems using the cached version, as the cache should be flushed whenever anything changes.</p> <p>From a Tcl page:</p> @@ -36,13 +36,13 @@ [lars_blog_get_as_string -url "/blog"] </pre></blockquote> <p>... for the cached version.</p> -<p>All of these are shown with an argument 'url' here, but they all -take a package_id argument instead, if you prefer that and know -what the package_id is. If nothing's supplied, the current package -is used, which is generally not what you want.</p> +<p>All of these are shown with an argument 'url' here, but +they all take a package_id argument instead, if you prefer that and +know what the package_id is. If nothing's supplied, the current +package is used, which is generally not what you want.</p> <h2>Technical Info</h2> <p>The package fully supports multiple instances. You can mount -several instances in your site map, and they'll stay properly +several instances in your site map, and they'll stay properly isolated from each other. Alternatively you can let multiple users post to one instance by granting create permissions. Mounting Weblogger under, say, /blog, you will have /blog/user/screenname @@ -51,46 +51,49 @@ DisplayUsersP to 1) or all entries posted to the instance (the default).</p> <p>Contents in your blog entries are assumed to be full-blooded -ADP-ified HTML, so don't give people access to post a blog (i.e. -grant create permissions on the instance) unless you trust them. -This also means that if you've added custom ADP tags, those are -also available to you in your blog.</p> +ADP-ified HTML, so don't give people access to post a blog +(i.e. grant create permissions on the instance) unless you trust +them. This also means that if you've added custom ADP tags, +those are also available to you in your blog.</p> <h2>Permissions</h2> <ul> <li>'read' means people can read entries.</li><li>'create' means people can create entries and -edit/publish/draft/delete their own entries.</li><li>'write' means people can edit/draft/publish/delete all entries -in the package instance.</li><li>'admin' means people can define categories, etc.</li> +edit/publish/draft/delete their own entries.</li><li>'write' means people can edit/draft/publish/delete all +entries in the package instance.</li><li>'admin' means people can define categories, etc.</li> </ul> <h2>weblogs.com update ping</h2> <p>There are a couple parameters governing this feature. You can turn it on or off on a per-package basis. And you can specify which -URL you want to export to weblogs.com, in case it's not the one the -package instance is mounted at. This can be useful if you're -including the blog on other pages, for example your site's front -page. Thanks to Jerry Asher for the code to do this.</p> +URL you want to export to weblogs.com, in case it's not the one +the package instance is mounted at. This can be useful if +you're including the blog on other pages, for example your +site's front page. Thanks to Jerry Asher for the code to do +this.</p> <h2>RSS Feed</h2> <p>The RSS feed is version 1.0 only, and uses the rss-support package. You should be able to simply visit the admin page of your -new blogger instance and click the "Setup RSS" link, and you'll -have an RSS feed.</p> -<p>Then you'll need to set the parameters and say that your +new blogger instance and click the "Setup RSS" link, and +you'll have an RSS feed.</p> +<p>Then you'll need to set the parameters and say that your rss_file_name is at /where-your-blogger-instnace-sists/rss/rss.xml. -If you leave this blank, we won't advertise your RSS feed URL +If you leave this blank, we won't advertise your RSS feed URL anywhere.</p> <p>You can also supply your own channel image through the parameters.</p> <h2>XML-RPC APIs</h2> <p>The Blogger and MetaWeblog APIs are supported. An <a href="http://archipelago.phrasewise.com/rsd">RSD</a> link is placed on -your Blog's front page, allowing XML-RPC client tools to -automatically discover which API's they can use. See the <a href="/doc/xml-rpc">XML-RPC package documentation</a> for more details. -Disable the XML-RPC server to disallow access to your blog via -XML-RPC.</p> +your Blog's front page, allowing XML-RPC client tools to +automatically discover which API's they can use. See the +<a href="/doc/xml-rpc">XML-RPC package documentation</a> for more +details. Disable the XML-RPC server to disallow access to your blog +via XML-RPC.</p> <h2>Posting From News Aggregator via URL</h2> <p>Some news aggregators can blog items you read via simply sending -you to the proper URL. Here's what you need to specify in <a href="http://www.bradsoft.com/feeddemon/index.asp">FeedDemon</a> to make -Blog-this-item work there:</p> +you to the proper URL. Here's what you need to specify in +<a href="http://www.bradsoft.com/feeddemon/index.asp">FeedDemon</a> +to make Blog-this-item work there:</p> <pre> -<i>URL-of-your-blog</i>/entry-edit?title=$ITEM_TITLE$&title_url=$ITEM_LINK$&content=$ITEM_DESCRIPTION$ +<em>URL-of-your-blog</em>/entry-edit?title=$ITEM_TITLE$&title_url=$ITEM_LINK$&content=$ITEM_DESCRIPTION$ </pre> <h2>Road Map</h2> <ul> @@ -103,47 +106,56 @@ <h2>Version History</h2> <ul> <li> -<b>1.0</b> Added support for categories, cleaned up permissions -handling, styled with stylesheets, trackback support.</li><li> -<b>0.9.2</b> Added parameters to control the number of entries -shown on the front page (July 10, 2003)</li><li> -<b>0.9</b> Added support for multiple users. (June 10, +<strong>1.0</strong> Added support for categories, cleaned up +permissions handling, styled with stylesheets, trackback +support.</li><li> +<strong>0.9.2</strong> Added parameters to control the number +of entries shown on the front page (July 10, 2003)</li><li> +<strong>0.9</strong> Added support for multiple users. (June +10, 2003)</li><li> +<strong>0.8.7</strong> Fixed notifications to include the +title_url, and to not have extra spaces in the month name. (May 11, 2003)</li><li> -<b>0.8.7</b> Fixed notifications to include the title_url, and -to not have extra spaces in the month name. (May 11, 2003)</li><li> -<b>0.8.6</b> Cleaned up RSS-support even more and made it work -under Oracle. Also made a slight style change, using the -&raquo; (») style for action links, which I've adopted -for other packages. It's less intrusive than the harshly-colored -arrow-box.gif I used to use. (May 9, 2003)</li><li> -<b>0.8.5</b> Added title URL, cleanup (March 28, 2003)</li><li> -<b>0.8.4</b> Oops, getting behind on the version history. In -the last few releases, I've rearranged a bunch of templates to make -it more consistent and easier to customize; I've fixed the code -that sets up the RSS stuff, so you can now simply go to the admin -page and say "setup RSS"; I've integrated the new richtext widget -which I added to the templating system. (February 6, 2003)</li><li> -<b>0.7d</b> Finished port to Oracle. Upgraded PG drop script. -Renamed RSS proc which requires running the SQL upgrade script (for -PG). Bug-fix to bypass 'draft' and publish directly. -vinodk -(August 15, 2002)</li><li> -<b>0.6.4d</b> Added poster information, optional per parameter. -Added "url" shortcut variable to the blog template. Updated -documentation. (July 23, 2002)</li><li> -<b>0.6.3d</b> Added drop scripts, and made the create script -call rss-register. Fixed minor bugs. (July 22, 2002)</li><li> -<b>0.6.1d</b> Fixed RSS last update bug. (Jun 2, 2002)</li><li> -<b>0.6d</b> Added RSS feed. Woohoo! (June 1, 2002)</li><li> -<b>0.5d</b> Added weblogs.com update ping. (June 1, 2002)</li><li> -<b>0.4d</b> Added Google link, new style. (May 31, 2002)</li><li> -<b>0.3.3d</b> Added Peter Marklund's arrow-box.gif patch. (May -13, 2002)</li><li> -<b>0.3.2d</b> Missing files from the distribution.</li><li> -<b>0.3d</b> Improved admin interface, added documentation. -(March 24, 2002)</li><li> -<b>0.2d</b> Allow and show comments on blog. (March 23, +<strong>0.8.6</strong> Cleaned up RSS-support even more and +made it work under Oracle. Also made a slight style change, using +the &raquo; (») style for action links, which I've +adopted for other packages. It's less intrusive than the +harshly-colored arrow-box.gif I used to use. (May 9, 2003)</li><li> +<strong>0.8.5</strong> Added title URL, cleanup (March 28, +2003)</li><li> +<strong>0.8.4</strong> Oops, getting behind on the version +history. In the last few releases, I've rearranged a bunch of +templates to make it more consistent and easier to customize; +I've fixed the code that sets up the RSS stuff, so you can now +simply go to the admin page and say "setup RSS"; I've +integrated the new richtext widget which I added to the templating +system. (February 6, 2003)</li><li> +<strong>0.7d</strong> Finished port to Oracle. Upgraded PG drop +script. Renamed RSS proc which requires running the SQL upgrade +script (for PG). Bug-fix to bypass 'draft' and publish +directly. -vinodk (August 15, 2002)</li><li> +<strong>0.6.4d</strong> Added poster information, optional per +parameter. Added "url" shortcut variable to the blog +template. Updated documentation. (July 23, 2002)</li><li> +<strong>0.6.3d</strong> Added drop scripts, and made the create +script call rss-register. Fixed minor bugs. (July 22, 2002)</li><li> +<strong>0.6.1d</strong> Fixed RSS last update bug. (Jun 2, 2002)</li><li> -<b>0.1d</b> Initial version. (February 18, 2002)</li> +<strong>0.6d</strong> Added RSS feed. Woohoo! (June 1, +2002)</li><li> +<strong>0.5d</strong> Added weblogs.com update ping. (June 1, +2002)</li><li> +<strong>0.4d</strong> Added Google link, new style. (May 31, +2002)</li><li> +<strong>0.3.3d</strong> Added Peter Marklund's +arrow-box.gif patch. (May 13, 2002)</li><li> +<strong>0.3.2d</strong> Missing files from the +distribution.</li><li> +<strong>0.3d</strong> Improved admin interface, added +documentation. (March 24, 2002)</li><li> +<strong>0.2d</strong> Allow and show comments on blog. (March +23, 2002)</li><li> +<strong>0.1d</strong> Initial version. (February 18, 2002)</li> </ul> <h2>License</h2>