[[PageOutline(2-5,Contents,pullout)]]

= MyPagePlugin for Trac =

== Description ==

This plugin for Trac 1.0 enables some convenient facilities for maintaining a "personal journal" in a sub-hierarchy of the TracWiki.

For now, the plugin is hosted on GitHub (https://github.com/cboos/trac-mypage-plugin), until trac-hacks supports Git (1.0 *cough* *cough*...)


Excerpt from the README.wiki:
----
=== Introduction ===

Simple plugin designed to help you maintain a "journal" of your daily
activities with wiki pages. The main idea is to have a main navigation
link named ''`MyPage`'' which takes you to your "page of the day", in
edit mode.

If that page doesn't exist already, it will be filled with the content
of a !PageTemplates, but with a twist: some tokens will be
automatically replaced, in particular for giving you the possibility
to include or refer to the previous page of the day...

The intended use is to have a quick but effective way to track the
ongoing activities of the day in the form of free wiki markup, and to
easily keep a continuity with the activity that occurred the days
before.

Works best with the TH:WikiExtrasPlugin and its !WikiPhrases...

=== Detailed mode of operation ===

When clicking on a ''`MyPage`'' top-level navigation link, one will
return to the edit preview mode of the "page of the day", which is a
normal wiki page of the form `/wiki/<userid>/<iso8601-date>`. If that
page doesn't yet exist, it will be created, eventually using an
appropriate page template (`PageTemplates/MyPage/<userid>` or
`PageTemplates/MyPage` - see !PageTemplates).

(Technically, this is achieved by redirecting the `/mypage` URL to the
actual page of the day with `?action=edit`)

Moreover those templates can contain some special markup which will
get replaced by dynamic content when inserted as the initial content
of the page of the day. The macro `[[MyPageHelp]]` lists the available
tokens: ![[MyPageHelp]]

This replacement will only happen when creating the ''page of the
day''. If one wants to create such pages as normal wiki pages, retro-
or pro-actively, the page will start empty or using the normal
!PageTemplates filling mechanism, i.e. no expansion of these tokens
will take place.

----

== Bugs/Feature Requests == 

Existing bugs and feature requests for MyPagePlugin are 
[https://github.com/cboos/trac-mypage-plugin/issues here].

If you have any issues, create a 
[https://github.com/cboos/trac-mypage-plugin/issues/new new ticket].

== Download ==

Download the zipped source from [https://github.com/cboos/trac-mypage-plugin/zipball/master here].

== Source ==

You can check out MyPagePlugin from [https://github.com/cboos/trac-mypage-plugin.git here] using Git, or [https://github.com/cboos/trac-mypage-plugin browse the source] with ~~Trac~~ GitHub :-(

== Example ==

One of my early "!MyPage", showing the embedding of the content of the previous page (itself still embedding part of its previous page).

[[Image(MyPage.png)]]

The page `PageTemplates/MyPage` would typically contain something like this:

{{{
= $MYPAGE_USER: $MYPAGE_DATE ($MYPAGE_ISODATE)

== New Today

== Continuing...

$MYPAGE_LAST_PAGE_QUOTED

{{{#!div class=important
//(remove this section in your own [[wiki:/PageTemplates/MyPage/$MYPAGE_USER]] page)//

[[MyPageHelp]]
}}}

}}}

Use this as a starting point when creating your //own// template, i.e. `PageTemplates/MyPage/<user>`.

== Author/Contributors ==

'''Author:''' [wiki:cboos] [[BR]]
'''Maintainer:''' [wiki:cboos] [[BR]]
'''Contributors:'''