- Tag-test-version
- 1.0
- Description
- Test tag file - note that this is in the header
- Id
- something
- Tag
- some value
- NextTag
- next value
- Id
- nextthing
- Description
-
This is a multiline description Here is the second line
- Priority
- 50
- Id
- anotherthing
- Description
- just a description
- URL
- http://www.example.com/
- Purpose
- testing URL display
- Priority
- 20
- Id
- yetanotherthing
- Priority
- 60
- Id
- importantthing
- Priority
- 5
taglog-0.2.6/manifest.txt 0000644 0001750 0001750 00000000373 13534701742 014032 0 ustar john john cal2.xbm logEdit.tcl mainwin.tcl pkgIndex.tcl smtp.tcl tag.tcl taglog.xbm taglog_action.tcl taglog_contact.tcl taglog_help.tcl taglog_help_en.tag taglog_init.tcl taglog_project.tcl taglog_report.tcl taglog_stack.tcl taglog_util.tcl taglog_widgets.tcl taglog-0.2.6/Makefile 0000644 0001750 0001750 00000001612 13534752765 013133 0 ustar john john # Make file for the taglog program version: src/taglog grep 'set version' src/taglog | cut -d' ' -f 3 > version maketar: version ./sort_taghelp src/taglog_help_en.tag ./sort_taghelp src/taglog_help_de.tag ./sort_taghelp src/taglog_help_fr.tag ./sort_taghelp src/taglog_help_nl.tag # tagextract -m Project -eq taglog <~/diary/actions.tag | tagextract -m Status -eq Pending > doc/taglog_todo.tag cp -a ../taglog ../taglog-$(shell cat version) tar -czv --dereference --exclude ".git" -f ../taglog-$(shell cat version).tar.gz -C .. taglog-$(shell cat version) rm -rf ../taglog-$(shell cat version) pkgindex: taglog pkg_mkIndex src/. src/*.tcl taglog.exe: taglog.vfs cp taglog taglog.tcl sdx wrap taglog -runtime /usr/local/lib/tclkit/tclkit-win32.upx.exe mv taglog taglog.exe mv taglog.tcl taglog rm -r taglog.vfs taglog.vfs: taglog tclsh install.tcl -vfs clean: # Nothing to do for clean taglog-0.2.6/sort_taghelp 0000755 0001750 0001750 00000002457 13534701742 014111 0 ustar john john #!/usr/bin/env tclsh # # This program sorts taglog_help files by Id field, allowing the taghelp # routine to binary search them # # Copyright John Lines (john+taglog@paladyn.org) January 2002 # # This program is released under the terms of the GNU Public Licence # # Version 0.0.2 sorts in a case insensitive manner # set version 0.0.2 global auto_path # tag.tcl should be in a real library directory or in the script dir set scriptdir [file dirname [info script]] lappend auto_path $scriptdir package require tag proc sorthelp { fn } { # # file copy $fn $fn.unsorted set helpentries [tag readfile $fn] #set sortentries [tag sort $helpentries Id -ascii ] set sortentries [tag sort $helpentries Id -dictionary ] # # The header should be entry 0 (becuase it does not have an Id field and # null sorts before everything else # # Put a Sorted-date header entry in there. set header [lindex $sortentries 0] #tag setorreplace header Sorted-date [clock format [clock seconds] -format "%Y-%m-%d %H:%M:%S"] tag setorreplace header Sorted-date [clock format [clock scan "next 10 seconds"] -format "%Y-%m-%d %H:%M:%S"] tag setorreplace header Sort-key Id set sortentries [lreplace $sortentries 0 0 $header] tag writefile $fn $sortentries } global argv # only take one argument for now set fn [lindex $argv 0] sorthelp $fn taglog-0.2.6/doc/ 0000755 0001750 0001750 00000000000 13534701742 012225 5 ustar john john taglog-0.2.6/doc/tutorial3.html 0000644 0001750 0001750 00000013444 13534701742 015047 0 ustar john john
Taglog tutorial - Preferences
Taglog comes with a set of defaults for the way it is set up which suit many people, but is intended to accommodate a range of user preferences for the way things look, or the places files are stored. There preferences are saved in a configuration file which is read in when the program is started.You can edit the preferences settings with the 'File/Preferences' menu item.
You will see a window which will look like this:
The first thing to note about this window is that the window title contains the name of the configuration file. This is the full operating system file name with any "~" expanded so you can find out which preferences file you are using.
Within the window are a number of items you can alter
- Documentation Directory
- Taglog looks for its online help in this directory. Usually you do not need to change this. As with most labels in taglog you can see the online help by clicking on the label, and then on the Help item in the drop down list.
- Data directory root
- Taglog will store its data files in this directory and directories which it will create under here.
- Language
- The text within taglog is passed through the TCL message catalog and the help information is intended to be available in multiple languages. At present the only fully supported languages are English and German. If you wish to help with the translation please see the taglog internationalisation guide and send patches to the author. If you change languages then the help text will be available immediately in the new langage, but you will need to click OK in the preferences window and then restart the program to see all the text in your chosen language.
- Hours worked per day
- Some of taglog reports can be displayed as time in man days. This is where you can adjust the number of working hours in a day to be right for you.
- Date Format
- You can let taglog know your preferred date format here. Taglog always stores dates in ISO format (YYYY-MM-DD) in files, but the ability to have dates read and presented in your preferred format is being gradually added.
- History and Current Window depths
- You can decrease the amount of screen real estate that taglog uses by reducing these sizes.
- Number of 'Today' actions
- At the top of the main taglog window you can record a number of things you intend to do that day. That way you can remind yourself of your top priority tasks every time you look at taglog. The number of actions defaults to three. You can increase it if you feel very productive, or set it to zero to save screen space if you do not find the facility useful.
- Id Prefix
- If you are working with a group of people on the same projects then you can set your Id Prefix to your initials. This will distinguish your action aa.testproj.1 (if your Id is aa) from your colleages fb.testproj.1 (if their Id is fb)
- Start Procs
- Taglog runs a number of subroutines when it starts, to create windows, start timers etc. You can specify additional procedures here to customise the way taglog works for you. In particular if you specify "iconify_mainwin doShowProjects" then taglog will start with the Project Times window open and the main window iconified. You can use the Project Times window as a simple project timer, clicking on the projects to switch which one is active.
- SMTP Preferences filename
- Taglog uses a mail implementation written in TCL. This has its own configuration file, because it might be used in programs other than taglog. This preferences item tells taglog where to find the SMTP (Simple Mail Transport Protocol) preferences file.
- SMTP thishost
- Part of the SMTP protocol requires your computer to say what it is called. This allows you to set the name in case taglog has not detected it correctly.
- SMTP mailhost
- The SMTP implementation in taglog is very primitive. You should enter the name of a Smart Host which will accept mail from your computer, and be responsible for delivering it. For Unix systems localhost should be fine.
- SMTP email address
- You should enter your Internet style email address here
- SMTP port
- Leave this at 25 unless you understand what you are doing.
Starting with an alternative preferences file
Taglog normally looks for a preferences file in the following locations- ~/.taglog
- ~/taglog.cfg
taglog -- -c configuration-file-name
From Unix you could set this up as an alias.
From Windows, if you have set up a shortcut to taglog on your desktop
you can right click the icon and select
Properties and modify the Target of the Shortcut properties as shown.
You can use this to run taglog with a set of preferences on a network drive.
This set of preferences can specify the location of the data root as being
on that network drive as well.
Next Previous Contents Author: John Lines john+taglog@paladyn.org taglog-0.2.6/doc/Taglog_shortcut.jpg 0000644 0001750 0001750 00000002501 13534701742 016075 0 ustar john john JFIF C $.' ",# (7),01444 '9=82<.342 C 2! !22222222222222222222222222222222222222222222222222 H D" 3 !1"QAaq#2%4U ' 1!2q"ARa ? DELH^LFFߡ*>C%P-?E{IWj }q:;NbQ>g NȱUT=dž8nGv"Q.d{ jmT~@}MG0ЅdalQDdAd,otfD'*kߝ3%aki` }WU'7گڀ5 tGɦ =<'nl a Wsf~ȳ႞ ֣Q,՜ 1;Jc. N|; 3ll0Z6^WJ5 (ڋzHW# jeaK ,14MF#y=G W~˜ < B{_&Yߍy\Ec ;S c \yd m8П1VoKzeJfpeIG m1٭ ]?s12gi͉q@olŨbi7b7T>g U! m@UQ ˢ03!Ae(j-d;tx_+1 NŅn&-v*b,qNq
Taglog tutorial - More about Projects
Taglog uses the term Project to mean a label by which you wish to measure chunks of time.In conventional usage a project has a beginning, a middle, and an end - but in Taglog there may also be 'projects' which are ongoing. For example your company may want to account for time spent on Safety activities seperately from work which is directly charged to particular customers.
Attributes of a project
Start and End Dates
By default when you add a project the start date is set to the current date and the end date is not specified.If you are working beyond the end date of the project then it is 'Closed' - which means that it does not show up in the Project selector in the central menu bar for booking time to it. It will still show up when picking entries by project in the File/Open... selector.
Booking Code
It may be that your projects have useful titles, such as 'New Computer Suite', but that you are supposed to book to, for example 'P0152'. You can use the Booking Code field to record the names your time booking system wants you to use for projects, and use a more meaningful name for your own use.It could also be that your administrative processes generate the official booking code some time after you are expected to start work on the project. As long as you have a booking code by the time you generate the Time Bookings Report taglog will work quite happily on just a title.
Breaks
Projects which are labeled as 'Breaks' are ones which are not working time. If you have, for example, a lunch break which is not part of your working hours you could create a project called Breaks, and 'book' your lunch times to this project.Breaks projects are counted seperately in the reports.
Overheads
You may have activities which can not be associated directly with an individual chargeable project, but which should be spread in an equitable manner across your other projects - for example filling in your timesheets.You can create one, or more, projects which are flagged as Overheads.
Active Projects
If you have a large number of projects which are Open (that is, the current date is between their Start and End dates) then you may find that they become difficult to manage. By flagging the ones you are actively working on as Active they are moved to the top of the Project selection list.Projects which are marked as Active also always appear in the Project Times display invoked through Projects/View.
Immutable Projects
Projects which are flagged as Immutable are (like Breaks projects) not eligible to have Overheads time spread into them. You might wish to use the Immutable flag for projects such as Bank Holidays, Leave, or Sick Leave which should not be 'bulked out' with your administrative overheads.Working with Projects
Adding a Project
This is done through the Projects/Add menu item.Editing a Project
This is done through the Projects/Edit menu item. You are presented with a scrollable list of all the projects, and can use this to, for example change the Active flag on a project - if you start actively working on it - or possibly if your involvement with it is largely over. This is also where you set the end date of a project - usually to todays date, to indicate that it is Closed, and hence no longer available for new time bookings.Note that you might have Actions which are associated with a project - and if you close the project before you have finished all the actions (there is no check for this yet) then you will still accumulate time booked to those actions as booked to that project.
Deleting a Project
Projects can be deleted through the Projects/Edit menu entry. There is a 'Delete' checkbox at the end of each project line. Select the Delete checkbox for each project you wish to delete and click OK.You may want to keep projects around for a while after they are closed so that they still appear in the dropdown lists for the File/Open... selector.
Importing projects from a central server
It is also possible to set up a central server from which you can import information on the available projects. This is covered in the next section of the tutorial and is what the Projects/Update menu item does.Next Previous Contents Author: John Lines john+taglog@paladyn.org taglog-0.2.6/doc/seltime.jpg 0000644 0001750 0001750 00000027033 13534701742 014376 0 ustar john john JFIF XCREATOR: XV Version 3.10a Rev: 12/29/94 (PNG patch 1.2) Quality = 75, Smoothing = 0 C $.' ",# (7),01444 '9=82<.342 C 2! !22222222222222222222222222222222222222222222222222 Z" } !1AQa"q2#BR$3br %&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz w !1AQaq"2B #3Rbr $4%&'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz ? [VH9$! Lk#kO'G ^i} ͼqT1_:\ֹӃ,MOeپz_&֟OM?焟 y" l ZcBpf?7u
Ɲspd[ɏ"pܱ) (+LwaC<ᾁmk:sBHC y," h|%
|ux=qqi6Ȭr@'Q@ y'o,K";;$[?.#=/ꚿ&g_ϰv b,k*v(1 }nոq"4- * F F x϶# z@gCE l@?sۄ:w h Z# Z# ZcgZ
L Ğ8 sWX!f
2xٖ~?w+ @k @k'Q3Yޯ?͏X=x`Q%/
y
n Qmd4t ,힚Ƈ@ё
!RRE vOS%»-{k6BPĞjHC xOSh5 [C왜 eg T ϭ7N&D h h hmG vφ :A
~ u* _ V86 @=9/~? x, `u!:}nc BsS|wڼ { Ԓ6 i#Ҭ_(<5*{wUUmŞFy3ovy+53m,Z/Orś33Ty k0@xԍCɩ 2n =S`T6d7orW)^: Dx~?Q 7Bu7hߋ+LU*,]Yh'wpL) k$4z-^2G >FG3
0r4]ix(=$?[:# This tutorial takes your through the main facilities of the program.
Contents
I assume you have already installed taglog, as described in the
installation instructions Run it in the appropriate
way for your platform
The initial screen should look like this:
At the top is a menubar, below that is a window which shows the previous
entries for today, which will be empty if this is the first time you have
run the program. Below this is a bar with the buttons related to the current
entry - like this:
Note that the Start time should be the time that you started the program,
and that the End time will increase every minute.
Try entering some text in the entry window (the one at the bottom),
and then click on 'Next'
The text you entered in the entry window should appear in the days log
window, labeled with its start and end times.
The next stage is to add some Projects.
On the 'current' menubar is a button labeled Project - click on it to
produce a menu, which should include the names of the project or projects
you have just added. You can select the name of a project to be associated
with the current log entry by selecting the project through that menu entry,
or by entering the name of the project in the field next to the 'Project;
button. Note that entering the project in the field will not add it to
the list of available projects for selection.
Try making some log entries associated with different proejcts, then
click on Projects/View in the main menubar. A window will pop up showing
the time spent on all the projects you have used. Entries which have no
project associated with them are labeled as unknown.
You can find out more about Projects in the
Projects chapter of the tutorial.
You can also select an activity by *Right Clicking* on Next, which pops
up a menu of activities. Selecting one starts the next log entry, with
the activity field set to whatever you selected.
Under the Reports menu you can select "Time by Activity" which shows a
breakdown of how your time is spent on various activities.
The names of the activities are read from a file, usually called
activities in the same place as your other taglog files, but the
location of this file can be changed in the preferences.
You can use the slider to alter the time, or enter a new time. If the
'Adjust previous end time' box is checked (the default) then the end time
of the previous entry will be adjusted to match.
You can also exit by selecting 'Quit', which exits immediately, without
saving the current item.
You will be offered a popup with the dates for which there are log entries.
The dates are in the form monthday - for example 0704 is the
Fourth of July.
Select the dates you are interested in, and click OK. You can restrict
the display to a particular project by clicking on the Project button and
selecting its name from the drop down menu, or by
There is an option to save the displayed entries to a file, which can
be used to create a report of work on a particular project, for example
to mail to other people interested in progress on that project.
The time spent on the current project, and the total time spent is continously
updated. Note that if you have a project called 'breaks' (by default -
strictly any project in the breaks_projects list) then it is counted separately
from working projects,
You will see a pop up window like
Enter a week number, or increase or decrease using the '-' and '+' buttoms
and press 'OK'
There are other features of the program which are not yet covered in
this tutorial, some (such as actions) are not fully complete, but will
be added to the tutorial as soon as they are ready. Refer to the TODO list
to see which features are still waiting to be implemented, and to the changelog
to find out about recent changes. Please feel free to experiment, and to
let me know which facilities you find useful, and any ideas which may improve
the program
Most of the fields should prompt you to ask yourself questions about
the action
The possible values for Status are:
You can clear the current action by selecting the action titled "--" from the
list.
You can also select the fields from an action to be displayed - this
can be useful to allow you to see a summary of the actions, showing, for
example, only the titles of the actions.
You can also select actions by the date they are expected to start, or to
be completed.
You can select individual actions by Id (which is not very useful most of the
time as action Ids are not very memorable) or by title. The Id and Title
field names are menu buttons, and when you select them you get a list of all
the titles, or Ids, which match all the other criteria you have selected.
The menu entries for these buttons are only updated when you click on the
Refresh button to their left.
Changes you make by this means do not trigger any of the processes which
can happen when you change the attributes of an action by other means within
the program - for example if you change the status of an action there will
not be a mail message generated to the Email-status-to recipient.
This is done via the Actions/History menu item, which brings up a selection
box similar to that used to view an action. This time you are likely to
want to only select a small number (often just one) of actions, and each
one will be displayed in its own window with all the log entries associated
with that action.
You will see the key information about the action in the top frame of the
window, including the total time spent so far on this action, and (if
it was specified when the action was added) the Expected-completed-date and
the Expected-time.
The next frame contains the history of the action, showing what was done,
and when.
At the bottom of the History Window is a 'Revise' button. Pressing this
button causes the action information to be updated with a
Revised-expected-completed-date and a Revised-expected-time. Note that these
are stored as different fields in the action, so you can see the difference
between your original estimate and the current estimates of how long the
action will take, and when you expect it to be completed.
The bottom of the history window also provides a button to allow you to
save the history of the action to a file, and a Cancel button - to remove
the window.
To do this select Actions/Extra.../Archive Old Actions from the top
menu. This will move all actions which were Completed or Aborted more than
one month ago to an archive file, called actions-yyyymm.tag, where
yyyy is the year and mm the month of the date of the archive.
To save the to a file select Reports/Weekly time bookings by project
from the main menu and set the week you want to report for.
Select Save As... from the report display. You will be prompted for
the file name to use to save the displayed times as a CSV file.
This is followed by as many lines as there are projects, starting with a
project booking code and then the times spent on that project on each
day of that week, all separated by commas.
You will still be prompted to confirm the filename.
If you are saving to the same kind of system as the one where the file will
be read (or you have a flexible program reading the files) then you do not
need to set this, but if you do then put the approporiate lines in your
taglog configuration:
Once this is enabled you can update your current list of available projects
via the Projects/Update menu entry.
Note that this URL could be something like
Taglog will detect a project being removed from the active projects list
downloaded here and will set the EndDate of such projects to todays date.
Actions are stored in a file called actions.tag in the diary directory.
Users preferences are stored in a file called '.taglog' under Unix,
or 'taglog.cfg' under Windows, both in the user's home directory. The preferences
file stores the projects the user books to, and can be used to override
the default preferences set in the program. The user preferences file must
be valid tcl script as it is sourced when the program starts.
You can edit the preferences settings with the 'File/Preferences' menu item.
You will see a window which will look like this:
The first thing to note about this window is that the window title contains
the name of the configuration file. This is the full operating system file
name with any "~" expanded so you can find out which preferences
file you are using.
Within the window are a number of items you can alter
From Windows, if you have set up a shortcut to taglog on your desktop
Taglog es software libre y se lanza bajo términos de la licencia pública de GNU.
In conventional usage a project has a beginning, a middle, and an end - but in Taglog there may also
be 'projects' which are ongoing. For example your company may want to account for time spent on
Safety activities seperately from work which is directly charged to particular customers.
If you are working beyond the end date of the project then it is 'Closed' - which means that it
does not show up in the Project selector in the central menu bar for booking time to it.
It will still show up when picking entries by project in the File/Open... selector.
It could also be that your administrative processes generate the official booking code some time
after you are expected to start work on the project. As long as you have a booking code by the
time you generate the Time Bookings Report taglog will work quite happily on just a title.
Breaks projects are counted seperately in the reports.
You can create one, or more, projects which are flagged as Overheads.
Projects which are marked as Active also always appear in the
Project Times display invoked through Projects/View.
Note that you might have Actions which are associated with a project - and if you
close the project before you have finished all the actions (there is no check for
this yet) then you will still accumulate time booked to those actions as booked to
that project.
You may want to keep projects around for a while after they are closed so that they
still appear in the dropdown lists for the File/Open... selector.
Ɲspd[ɏ"pܱ) (+LwaC<ᾁmk:sBHC y," h|%
|ux=qqi6Ȭr@'Q@ y'o,K";;$[?.#=/ꚿ&g_ϰv
What are my priority jobs for today ?
How can I spend less time on routine adminstrative tasks ?
Taglog is written to answer these questions.
The current version is
0.2.6
Taglog provides an electronic workbook, combining logging of time to projects
with keeping a detailed diary of what you actually do. Individual work
elements can be tagged by project, allowing you to produce, for example, a
record of work on one particular project, even if your time is spread across
a number of projects.
Work items can also be tagged by activity type - for example meeting, phone,
programming etc - allowing you to analyse where your time is going by activity.
Note that this activity type is orthogonal to the project axis, so that - for
example - user support would be a project - in the larger sense WHAT you are
doing - and phone calls to users - HOW you are doing it - would be the activity
type.
Look here for the latest changes
Taglog is what is known as Free Software, or Open Source.
Taglog is written in the TCL scripting language, which is available for Unix,
Windows and Macintosh systems.
See http://www.tcl.tk - the TCL developer Exchange for more
information - including downloading TCL for free.
Taglog is in regular use on Unix (Linux and Solaris) and Windows systems.
The installation instructions are included with the
distribution, but are available here for convenience.
Windows users will need a program, such as
Powerarchiver or
pkzip to unpack the distribution.
Alternatively you could install
Cygwin which gives you many powerful Unix tools for free on your Windows
PC.
If you are not a TCL programmer, but can write in a language for which
taglog internationalisation is not yet available you can still help, as
described in the Internationalisation
Guide or translating this page, or the tutorial
Other links can be found in the Time Management Resources page.
Taglog software livre e liberado sob os termos da licena pblica de GNU.
a`:G:VV1MD4iJi +QlXÆo5HjhLSS /96Do]
[ .+VRJ (]Kh6UCo-֡\yī
8$쓐*&#^R\Ci2Km i)ZB%Y
@$ EwJyfCOfL!UrA
>Gm}lfLg n#R'fLg n#ҠmM}fڷO>d¹g{y.! ,{xc̛uQ {xc Gf 5=y}g^^.+{VɼRO qnfoFP?ȼR# s\ ' AX2
`NO
wG\4e'R 7ܦT^}6; x =n-{g,R=ύNV`}Jc6YaZ[QJDRH$?'lzFM 7Csk7LeX >{%1M=~bD)B[0m )ިǰ=¸GT#3ln I{u
f)'RvV= & {K 7E ?$ `~ pPs^Es]Rrd[}uR *OEQwyfx x|s v{FwBs0įC` 6Tt6p^Mm Zї\=m1gl*Y;!6
b˒rϸJώ[{)jz0Q[bD-e]|}}ظ'\ 3_e}ocJrzĪlUju9AgN
Xfl`Rp
TaglogTutorial
Welcome to taglog This program acts as an electronic diary, with
facilities for logging the time spent on different proejcts. It also has
facilities for managing actions, and booking time to projects.
I hope you find the program useful
Author: John Lines
john+taglog@paladyn.org
taglog-0.2.6/doc/tutorial1.html 0000644 0001750 0001750 00000020732 13534701742 015043 0 ustar john john
Taglog Tutorial - Getting started and basic logging
Contents
Getting Started
What you have learned so far should help you if you simply wish to
keep a record of what you did during the day - an electronic day book,
with the advantage of having the entries automatically time stamped.
Logging by Project
Click on Projects on the top menubar, which will bring down a sub menu.
Click on 'Add...'
A window will pop up which allows you to type in the name of a project.
Enter names for the projects you spend time on.
Logging by Activity
You may also wish to associate log entries by activity. The activiites
can be selected from a sub menu of the Project button in the 'current'
menubar. The current activity can be cleared by selecting the entry '--'.
Adjusting the Start Time
Sometimes you will`not be able to click the next button at the time that
you start a new acitvity - you might not be at your computer, or you may
forget to do it. If you realise that the current log entry should have
started earlier than the time shown you can click on the 'Start' button
to correct it. This will pop up a window like this:
Exiting the program
To exit the program at the end of the day select 'File' in the main
menubar, and then 'Exit'. You will be prompted to enter a summary of the
days events. You can skip this by pressing 'Cancel' on the summary window.
Viewing previous logs
Once you have several days worth of logs you will find that you want to
find out what you did on a particular day, or follow the history of a particular
project. To do this select 'File/Open...' from the main menubar.
typing its name in the field next to the Project button.
Displaying the time
spent on projects
The program keeps a running total of the time spent on all the projects
you have used today. To display it use the option 'Projects/View' in the
main menu bar.
Reporting project
bookings for a week.
Once you have been running the program for a week you can produce a report
of time spent, by project, for the whole week, with summaries of total
time per day, and total time per project. To do this select 'Reports/Weekly
time booking by project' from the main menubar.
You can display the times as hours and minutes or as decimal hours,
or as decimal days.
Next
Previous
Contents
Author: John Lines
john+taglog@paladyn.org
taglog-0.2.6/doc/tutorial2.html 0000644 0001750 0001750 00000021375 13534701742 015050 0 ustar john john
Taglog tutorial - Actions
This program uses the term 'Action' where some systems use 'Task'.
It describes something which you intend to do. Actions work best if they
describe a small lump of work. That way you can cross them off quickly.
A future release of the program may have the ability to specify high level
tasks, and then split them into finer detail, but the present version is
aimed at detailed tasks.
Adding actions
To add an action use Actions/Add... in the main menu.
This program uses priorities where the numerically lowest are most
important. The default priority is 50. This may seem like a large number,
but the idea is that if you consider a scheme of priorities like
If someone asks you to do a piece of work, or you generate a job for yourself,
pick a suitable priority in this range - then multiply it by ten. You can
then fine tune the priorities of individual actions to decide which of
the Urgent actions should be done first. Note that the priority may
be used in a future release to estimate elapsed time spent on an action
on the assumption that you will spend (100-priority) percent of your time
on that task - i.e. it will estimate that you will spend 90% our your time
on a priority 10 task, 50% on a priority 50 action etc.
What can be done to minimise them.
Actions start as Pending and become Active (or they may start as Active
as soon as they are entered). They end up Completed or Aborted
Integrating actions with time logging
If you click on the Action label in the centre menu bar you will
be presented with a drop down list of the actions which are currently in
the Active state. Selecting one of these actions will set the current
project to the project associated with that action, and that action will
be associated with the current log entry. You can thus use taglog to track
how long an action has taken.
Viewing Actions
The Actions/View menu item allows you to view your actions. You
can select the actions to view according to the Project they are associated
with, their Status or their Priority.
Editing Actions
When you have viewed a set of actions, as described above, you can right click
on an action and this will bring up a new window allowing you to edit it.
Changing the Status of an action
In the Actions menu are entries which allow you to Complete an Active action,
to Activate a Pending action and to Abort actions which are Active or Pending.
These present a menu of the titles of all the actions in the appropriate
state (for example all the Active actions are presented for completion).
Simply select the action by its title and it will be changed to the new
state.
Viewing the History of an action
In section 1 of the tutorial you saw how to view all the log entries which were associated with a particular project, over some space of time. As you start to
use actions more you may find that you want to view the history of an
individual action.
Shortcut to editing the current action
If you right click on the word Action in the central menu bar, while
there is a current action shown in the box next to it, then a new window
will pop up which will let you edit the current action.
Long term action maintenance
After you have used actions for a while you will find that the current
actions file will grow. From time to time, depending on how heavily you use
actions, you may want to move old actions to an archive file.
Next
Previous
Contents
Author: John Lines
john+taglog@paladyn.org
taglog-0.2.6/doc/glossary.html 0000644 0001750 0001750 00000000505 13534701742 014756 0 ustar john john Taglog Glossary
taglog-0.2.6/doc/stack4.png 0000644 0001750 0001750 00000016053 13534701742 014131 0 ustar john john PNG
IHDR ) O ɓ IDATx= yR)8RHOvNr/*Ȃ
*UE*^ #E* A"0 *v.,FMqm9osfA̝93/Ϟٙ ~o W~翚:
n~=m4 !;u "^|)>.:1>>P ``Fbu}wG?畇 ~u>ѹO 0,||Ǐ =ꂮd@Ugv;G'xԌό @9FyU`>%sϻI >|C5
Z=tqq<; @9撗( &͛ߺuї_~+֭[Ɵz rO%{>t/N+S7}JSYGCJ#'p`o;}7ߨ\u-U wnvn{>Pu=_u·Ǐ N'Rg r_Y|wOgˀ[G:W }].^y ccu]~
NϞ9H,FxvBҧ)wN j2xBi? ͋/Ԕ4ϟ?wN/)zN% GwuVIH .?|sP`Q>fO#/*P~8ֽM]\w
|'?3*'g* 'FN2 ksno4GvQoG}W~=ƅ =ll`\/GԹ5 \`အ4{
Ec|dLO
g~1~3S}Tcpl3c\yY`⯿ڸ~ٳ;w8'~sܹ~~={?GH HoO{^_>}ϓ'OEOYiO%: T9 0 ]___P[73o|7aE 0 Ϲu29r?ϭ'8o =Sr#|_:0 9l6{
@~8R nS4o {c @m @m @m @m @m @m @mV+>: j ,VP$vÈĒF/B\E%
ZN71 DV}
#Taglog tutorial - working with other systems
Although taglog is primarily focussed on time management for an individual
it has some features which help it to work with other systesm.
These features require some setup outside of taglog so if you are working
purely standalone you can skip this section.
Saving Time Bookings for import to another program
You can save the output of the weekly time bookings as a Comma Separated
Value file.
This can be used to automate entry into a corporate time recording system,
but the exact details will depend on the requirements of your corporate system.
File Format
The file is saved as a line containing the dates for which the report has
been generated, comma seperated with an initial leading comma.
The dates are expressed as Day/Month.
Advanced facilities
There are some advanced facilities which can be set by manually editing your
taglog configuration file (~/.taglog on Unix or taglog.cfg
on Windows).
You can edit this file with an editor and make changes in the section after
the line which says
# above this line is automatically saved - put your changes below here
Even if you do know know the TCL language in which taglog is written it is
fairly simple to follow the syntax of the lines above the marker, which are
set by the File/Preferences menu entry.
Default Timebookings Save File
You can save the default file for the SaveAs operation by putting lines
into your taglog configuration file which read
global default_save_timebookings_file
set default_save_timebookings_file "some filename"
Timebookings File Format
Unix and Windows have different ways to indicate the end of a line of text.
If you are running taglog on a Unix or Linux system and saving your Timebookings
CSV file to a network drive on a Windows shared drive where it will be read
by an application expecting a Windows text file, or you are running taglog
on a Windows PC to a network drive where the CSV file will be read by a Unix
application you may need to change the file format.
Saving in Windows format
global timebookings_file_format
set timebookings_file_format crlf
Saving in Unix or Linux format
global timebookings_file_format
set timebookings_file_format lf
Updating Projects information over HTTP
If your organization has a web server which can deliver a list of the
currently available project names and booking codes then you can set up
a URL in the Projects URL field in preferences.
http://projects.example.com/projects-list.php?jl
to deliver only the projects relevant to a particular person.
Setting up the Projects information server
This section is under construction.
The Projects information server should deliver the projects which are
valid for the particular user (or possibly just the same set of projects
to everybody) in the tagged format described in
https://johnlines.github.io/tag-types/
for example it should look like
Tag-accountproj-version: 1.0
End:
Name: breaks
NextActionId: 1
Code:
Flags: Breaks
Flags: Active
StartDate: 2002-12-11
End:
Name: general admin
NextActionId: 1
Code:
Flags: Overheads
Flags: Active
StartDate: 2002-12-11
End:
Name: Major Project1
NextActionId: 1
Code: MP1
StartDate: 2002-12-11
End:
and so on.
Next
More about Projects
Contents
Author: John Lines
john+taglog@paladyn.org
taglog-0.2.6/doc/stack1.png 0000644 0001750 0001750 00000045662 13534701742 014136 0 ustar john john PNG
IHDR ) O ɓ gAMA a IDATxyd]VkoR/Z] la óg03`p4b0 Ah M<{n ~0̀ mK̓
Taglog reference manual
Files
By default taglog uses a directory called 'diary' which it creates
in the users home directory if it does not exist. Underneath this directory
if creates a directory called 'logyyyy' where yyyy is the current
year. Each days log entries are stored in a file called 'mmdd.tag'
where mm is the current month and dd is the day of month.
taglog-0.2.6/docs/ 0000755 0001750 0001750 00000000000 13603645436 012414 5 ustar john john taglog-0.2.6/docs/taglog-background2.gif 0000644 0001750 0001750 00000002707 13534701742 016561 0 ustar john john GIF87a,, , ,, ڋH扦ʶ L
ĢL*̦ JԪjܮ N
(8HXhx 9) i0Yyy XZjJZj7KaK{ڻ7Taglog tutorial - Preferences
Taglog comes with a set of defaults for the way it is set up which suit
many people, but is intended to accommodate a range of user preferences for
the way things look, or the places files are stored. There preferences are
saved in a configuration file which is read in when the program is started.
Starting with an alternative preferences file
Taglog normally looks for a preferences file in the following locations
It will use whichever of these files it finds first as the user's preferences
file. You can override this behaviour by starting taglog as
taglog -- -c configuration-file-name
From Unix you could set this up as an alias.
you can right click the icon and select
Properties and modify the Target of the Shortcut properties as shown.
You can use this to run taglog with a set of preferences on a network drive.
This set of preferences can specify the location of the data root as being
on that network drive as well.
Next
Previous
Contents
Author: John Lines
john+taglog@paladyn.org
taglog-0.2.6/docs/Taglog_shortcut.jpg 0000644 0001750 0001750 00000002501 13534701742 016260 0 ustar john john JFIF C
$.' ",# (7),01444 '9=82<.342 C
2! !22222222222222222222222222222222222222222222222222 H D" 3 !1"QAaq#2%4U ' 1!2q"ARa ? DELH^LFFߡ*>C%P-?E{IWj }q:;NbQ>g NȱUT=dž8nGv"Q.d{ jmT~@}MG0ЅdalQDdAd,otfD'*kߝ3%aki` }WU'7گڀ5 tGɦ =<'nl
a Wsf~ȳ႞ ֣Q,՜ 1;Jc. N|; 3ll0Z6^WJ5 (ڋzHW# jeaK ,14MF#y=G W~˜ < B{_&Yߍy\Ec ;S c \yd m8П1VoKzeJfpeIG m1٭ ]?s12gi͉q@olŨbi7b7T>g U! m@UQ ˢ03!Ae(j-d;tx_+1 NŅn&-v*b,qNqTaglog - Sistema de gerencia personal de tiempo
Taglog se diseña para cualquier persona que pase la mayoría de su día que se sienta en una computadora,
trabajando en varios proyectos. Usted puede hacer notas sobre lo que usted hace, como usted va adelante,
asociándolo a los proyectos que usted trabaja encendido.
En el final de la semana usted puede producir un informe de cómo su tiempo estuvo pasado, analizado por el proyecto para los propósitos de la reservación.
Usted puede visión entradas anteriores, por la fecha, o por proyecto.
Usted puede incorporar las acciones que usted se prepone tomar, asociarlas a un proyecto, y marcarlas como activas,
o terminar.
Taglog home page (English)
9E+xx#fؘm1WJH=BSI=6)qljի,[|oi~.Ѐ~9#,e?\J`1gm6hs:Gc]6̰
x3ZKN%f*0J5-[ܫ!2 !P. =gEQEQEQU5O^ MPНc#w`%p ښ H9Taglog tutorial - More about Projects
Taglog uses the term Project
to mean a label by which you wish to measure chunks of time.
Attributes of a project
Start and End Dates
By default when you add a project the start date is set to the current date
and the end date is not specified.
Booking Code
It may be that your projects have useful titles, such as 'New Computer Suite', but that you are
supposed to book to, for example 'P0152'. You can use the Booking Code field to record the names
your time booking system wants you to use for projects, and use a more meaningful name for your
own use.
Breaks
Projects which are labeled as 'Breaks' are ones which are not working time. If you have, for example,
a lunch break which is not part of your working hours you could create a project called Breaks, and
'book' your lunch times to this project.
Overheads
You may have activities which can not be associated directly with an
individual chargeable project, but which should be spread in an
equitable manner across your other projects - for example filling in
your timesheets.
Active Projects
If you have a large number of projects which are Open (that is, the
current date is between their Start and End dates) then you may find
that they become difficult to manage. By flagging the ones you are
actively working on as Active they are moved to the top of the
Project selection list.
Immutable Projects
Projects which are flagged as Immutable are (like Breaks projects) not eligible
to have Overheads time spread into them.
You might wish to use the Immutable flag for projects such as Bank Holidays, Leave,
or Sick Leave which should not be 'bulked out' with your administrative overheads.
Working with Projects
Adding a Project
This is done through the Projects/Add menu item.
Editing a Project
This is done through the Projects/Edit menu item. You are presented with a scrollable
list of all the projects, and can use this to, for example change the Active flag on
a project - if you start actively working on it - or possibly if your involvement with
it is largely over. This is also where you set the end date of a project - usually to
todays date, to indicate that it is Closed, and hence no longer available for new
time bookings.
Deleting a Project
Projects can be deleted through the Projects/Edit menu entry. There is a 'Delete' checkbox
at the end of each project line. Select the Delete checkbox for each project you
wish to delete and click OK.
Importing projects from a central server
It is also possible to set up a central server from which you can
import information on the available projects.
This is covered in the next section of the tutorial and is what the Projects/Update
menu item does.
Next
Previous
Contents
Author: John Lines
john+taglog@paladyn.org
taglog-0.2.6/docs/taglog.ico 0000644 0001750 0001750 00000000306 13534701742 014360 0 ustar john john ( ? { { ' taglog-0.2.6/docs/seltime.jpg 0000644 0001750 0001750 00000027033 13534701742 014561 0 ustar john john JFIF XCREATOR: XV Version 3.10a Rev: 12/29/94 (PNG patch 1.2) Quality = 75, Smoothing = 0
C
$.' ",# (7),01444 '9=82<.342 C
2! !22222222222222222222222222222222222222222222222222 Z"
} !1AQa"q2#BR$3br
%&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz
w !1AQaq"2B #3Rbr
$4%&'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz ? [VH9$! Lk#kO'G ^i} ͼqT1_:\ֹӃ,MOeپz_&֟OM?焟 y" l ZcBpf?7uTag Logging Program
Where does the time go ?
What is taglog?
Screenshot
This shot shows the main window, plus an action being added and a new project
(bookable entity) being added.
Downloading and Installing
The current version of the software is available at
the Github release page for taglog
The Tutorial
You may wish to read a taglog tutorial (which
is included in the documentation in the distribution) before you download.
Applications
You can find descriptions of how various kinds of people might use taglog
by following these links.
Note that these are just examples to draw out particular facilities of the
program
Developer information
Patches and suggestions are welcomed. Please bear in mind that taglog is
targetted at a range of platforms and TCL versions. The internal structure
is not fully stable, so there is not much developer documentation yet,
though there is a Unix manual page for the main tag.tcl package.
Further information
The log file format for taglog, and the file format for its actions files are
described in the tag-types home page
Github
Taglog is now a project on Github - to allow use of its code management and bug tracking
facilities, and you can obtain the releases from there as well.
Author: John Lines
john+taglog@paladyn.org
taglog-0.2.6/docs/stack2.png 0000644 0001750 0001750 00000015115 13534701742 014310 0 ustar john john PNG
IHDR ) O ɓ IDATxݽ} `q
$ʻ J^Ha9UrqW\-JiIN!HʆmH J]
[dMA
א<8 r!odQ @^wt1 ~åKɓ~Z?Ѳ`Bi"tym 0>(=/_Κ |,u˿'&LʋdyWSosϿ*~o}t_~̈́ &.b>/^;E/_ɪҗ~# ?݁\v03| w$OĒckѤϟ?y9Qeh<<<Taglog - Sistema de gerncia pessoal do tempo
Taglog projetado para qualquer um que gasta a maioria de seu dia que se senta em um computador, trabalhando em vrios projetos. Voc pode fazer anotaes sobre o que voc faz, porque voc vai longitudinalmente, associando o com os projetos que voc trabalha sobre. No fim da semana voc pode produzir um relatrio de como seu tempo foi gastado, quebrado para baixo pelo projeto para finalidades do booking. Voc pode ver entradas precedentes, pela data, ou pelo projeto. Voc pode incorporar as aes que voc pretende fazer exame, para as associar com um projeto, e marc-las como ativas, ou termin-las.
Taglog home page (English)