Changes between Version 45 and Version 46 of FullBlogPlugin


Ignore:
Timestamp:
Mar 7, 2015, 6:38:29 PM (19 months ago)
Author:
figaro
Comment:

Cosmetic changes, tagged with license

Legend:

Unmodified
Added
Removed
Modified
  • FullBlogPlugin

    v45 v46  
    11[[PageOutline(2-5,Contents,pullout)]]
    2 = Self-contained Blog plugin =
    32
    4 == Description ==
     3= Self-contained Blog plugin
     4
     5== Description
    56
    67This plugin provides a project Blog, but unlike TracBlogPlugin and SimpleBlogPlugin it does not use Wiki pages to store the content. It has no dependencies on other plugins.
     
    89This is a production-ready release, '''supporting Trac 0.11 and 0.12 installations'''. The current 0.11 branch is 0.12 compatible, but does not yet support other locales than English (no l10n/i18n support).
    910
    10 Basic features are:
    11  * Create, edit and view blog posts under a new 'Blog' menu a.
    12  * Browse post by month, category and author + and Archive page for all posts.
     11Basic features:
     12 * Create, edit and view blog posts under a new 'Blog' menu.
     13 * Browse post by month, category and author and Archive page for all posts.
    1314 * Attachments on blog posts.
    1415 * Comments for blog posts.
     
    1617 * Search for blog posts and comments.
    1718 * Admin page for basic settings and editing informational text in sidebar.
    18  * Permissions for `BLOG_VIEW, BLOG_COMMENT, BLOG_MODIFY_OWN, BLOG_MODIFY_ALL, BLOG_CREATE, BLOG_ADMIN`.
     19 * Permissions for `BLOG_VIEW`, `BLOG_COMMENT`, `BLOG_MODIFY_OWN`, `BLOG_MODIFY_ALL`, `BLOG_CREATE`, `BLOG_ADMIN`.
    1920 * Support for Trac fine-grained permissions security checks (based on resource / realm).
    2021 * Special handling of a post named 'about'.
     
    2526 * A `[[BlogList]]` news-listing macro with various display modes for pulling blog posts into the wiki.
    2627 * Change listener and manipulator APIs for hooking on to changes.
    27    * Spamfilter implementation included - thanks to athomas, ([3106] - forgot commit message...)
     28   * Spamfilter implementation included - thanks to athomas ([3106]).
    2829   * Sample plugin provided illustrating how to use the hooks.
    2930   * FullBlogNotificationPlugin adds email notification of changes to posts and comments.
     
    3738Feedback is most welcome - see [wiki:osimons] to get in touch with me by mail or on the #trac channel.
    3839
    39 == Macro ==
    40 A macro to display list of posts and extracts outside (or inside)
    41 the Blog module - most commonly Wiki pages.
     40== Macro
     41
     42A macro to display list of posts and extracts outside (or inside) the Blog module, most commonly Wiki pages.
    4243
    4344All arguments are optional:
     
    5657
    5758Example showing some available named arguments:
     59
    5860{{{
    5961[[BlogList(recent=5, max_size=250, period=2007/12, author=osimons, format=float, heading=Some Trac Posts)]]
    6062}}}
    6163
    62 The arguments for criteria are 'AND'-based, so the above example will render
    63 at most 5 posts by 'osimons' in December 2007.
     64The arguments for criteria are 'AND'-based, so the above example will render at most 5 posts by 'osimons' in December 2007.
    6465
    6566There is no heading unless specified.
    6667
    67 Without restriction on recent number of posts, it will use the number currently
    68 active in the Blog module as default for 'float' and 'full' rendering, but for rendering
    69 of 'inline' list it will render all found as default unless restricted. Additionally for
    70 'float' and 'full' it will truncate content if it is larger than a max_size (if set).
     68Without restriction on recent number of posts, it will use the number currently active in the Blog module as default for 'float' and 'full' rendering, but for rendering of 'inline' list it will render all found as default unless restricted. Additionally for 'float' and 'full' it will truncate content if it is larger than a max_size (if set).
    7169
    7270The `format=` keyword argument supports rendering these formats:
     
    7977Posts are rendered sorted by newest first for all modes.
    8078
    81 == Screenshots ==
     79== Screenshots
    8280
    8381The plugin in action (old-ish screenshot):
     
    8684To see the blog in action, visit its 'home' at http://www.coderesort.com/about/blog
    8785
    88 == Migration ==
     86== Migration
    8987
    9088There is a script available in the [source:fullblogplugin/0.11/contrib contrib] directory for migrating existing TracBlogPlugin users to the FullBlogPlugin.
     
    103101migrate-tracblog.py /path/to/environment
    104102}}}
    105  * Confirm the migration succeeded, then remove the old posts (if desired)
     103 * Confirm that the migration succeeded, then remove the old posts if desired:
    106104{{{
    107105#!sh
    108106migrate-tracblog.py /path/to/environment --delete-only
    109107}}}
    110 Take a look at `migrate-tracblog.py --help` for more options
     108Take a look at `migrate-tracblog.py --help` for more options.
    111109
    112 == Bugs/Feature Requests ==
     110== Bugs/Feature Requests
    113111
    114112Existing bugs and feature requests for FullBlogPlugin are
     
    118116[http://trac-hacks.org/newticket?component=FullBlogPlugin&owner=osimons new ticket].
    119117
    120 == Download and Install ==
     118[[TicketQuery(component=FullBlogPlugin,group=type,format=progress)]]
     119
     120== Download and Installation
    121121
    122122Either:
     
    129129}}}
    130130
    131 ''Note: on Fedora-14, Python 2.7,  Trac 0.11, trac did not see the plugin after easy_install and restart. Adding these two symbolic links in site_packages fixed it:''
     131''Note: on Fedora-14, Python 2.7, Trac 0.11, Trac did not see the plugin after easy_install and restart. Adding these two symbolic links in site_packages fixed it:''
    132132{{{
    133133#!sh
     
    137137''I don't know what the long-term effects of this not-by-the-books edit are with future upgrades.  A better egg hacker should probably correct my advice. (dr2chase)''
    138138
    139 == Source ==
     139== Source
    140140
    141141You can check out FullBlogPlugin from [http://trac-hacks.org/svn/fullblogplugin here] using Subversion, or [source:fullblogplugin browse the source] with Trac.
    142142
    143 == Get it working ==
     143== Configuration
    144144
    145145Follow these simple steps and configuration hints:
     
    170170}}}
    171171
    172 '''Upgrade''' on your Trac environment
     172'''Upgrade''' your Trac environment as follows:
    173173{{{
    174174#!sh
    175 $ trac-admin <env> upgrade
     175trac-admin <env> upgrade
    176176}}}
    177177
    178 == Available Plugins ==
     178== Available Plugins
    179179
    180180[[ListTagged(fullblogplugin)]]
    181181
    182 == Recent Changes ==
     182== Recent Changes
    183183
    184184[[ChangeLog(fullblogplugin, 3)]]
    185185
    186 == Author/Contributors ==
     186== Author/Contributors
    187187
    188188'''Author:''' [wiki:osimons] [[BR]]
    189 '''Maintainer:''' [wiki:osimons] [[BR]]
     189'''Maintainer:''' [[Maintainer]] [[BR]]
    190190'''Contributors:'''