Reference guides

[fishboy]

Thanks kwerner.  So does %duration% allow specifying a time format like starttime and endtime (duration,<timeformat>)?

[kwerner]

Yes, same as starttime.

[moby101]

Skin Reference

Timezone Reference

WidList

Eitel,
You and others are doing a fantastic job but to make it easier for other less experienced TodayPlus users, is it possible for you to indicate in this first message, the date of your reference files.  

For instance, I noticed Fishboy has posted another skin later, is there any way you can always have the latest reference files in your top post (with the date last updated along side it)

This would save us downloading an old file and also having to try to find the last one posted.
Many thanks

[Ripper]

I agree.. it is hard to identify the current Reference files as well as the current program. Would it be possible to use a more conventional format for naming the files. I have downloaded the current Skin Reference at least 3 times now... lol...

I was maybe thinking something like the following:

v0.9.8 TodayPlus.arm.exe

v0.9.8.00 Skin Reference Guide.txt


v0.9.8.01 Skin Reference Guide.txt
(in case there are any ammendments before the executable is updated)

[fishboy]

Unless srs objects, in future posts I will add the version number to the zip file (i.e. skin reference v0.9.8 r1.zip, where the last digit is the for document revisions).

[Ripper]

That would be awesome Fishboy.. thanks. I took a look at your skn guide it is also a nice piece of work though it seems to be a bit incomplete. Are you planning to upgrade it...?

I was actually going to edit it into a doc format that could be printed out and bound so that people could use it as a true reference manual.

But then, I realized that SRS is showing no signs of slowing down with his upgrades... so I was just wondering when, if, there will be another revision.

[fishboy]

A new version of the skin reference (and TodayPlus) are in the works.  I will post the reference when TodayPlus is released.  I have made some changes/correction for 0.9.8, but since I have also added stuff for the next version, I will have to wait to post it.  

I am removing some of the documentation and placing it into separate html files to help keep the skin file down (i.e. version history, weather icon id list, and other rarely used information).  The next release will use Microsoft's HTML filter to further decrease its size, which means it will no longer be a fully editable in word (i.e. table of contents can't be automatically rebuilt) except by me   .  This will help with those who use the reference on the Pocket PC.

And yes, you are correct, the skinning commands are in a constant state of flux at this time, which is why an electronic version is prefered.  Feel free to correct me on any documentation errors you or any one else find.  I would like to keep this document as error free and up to date as possible to help avoid confusion for new skinners.

[pli7]

Hi Fishboy,

Can you please help me understand what the Refresh Interval do in the RSS command (config.txt)?  Your reference says:

minimum time in seconds to refresh data when refresh button pressed / ActiveSync ends

I am having a hard time understanding this.  What is the refresh button?  Is it on the skin, or are you refering to the Synchronize button in ActiveSync?  Is this the minimum time allowed / alloted for a refresh?

Thanks in advance.

pli7

[JulioSilva]

Hello!

In the Today Command, <Variable>, sky -> Display the ?.
It displays the sky status, clear, rain, cloudy, etc.

Hope it helps.

jS

[fishboy]

pli7,

The refesh button is usually the icon with the curved arrows (one pointing up, the other down) but can vary for each skin.  It is the area/image associated with the imagebutton or button commands that specify the action value of 7 (refresh) in the skin file (i.e. imagebutton,156,2,refresh.png,t,0,7,,-1).  

The refresh interval specifies the minimum time to wait after last download before allowing new data to be downloaded (refresh button clicks and ActiveSync connections  are ignored until wait interval has expired).  When data is actually refreshed, a time stamp is each time data is succesfully downloaded.  If another refresh is performed before this interval (time stamp + refresh interval) no data will be downloaded.  

Example.  Last download = 10:00am, refresh inteval = 60.  Any clicks on the refesh button before 11:00 am will NOT download any new rss data.

Hope this helps.  By the way, in the future, please post all Help reguests in the Help & Support Forum so that it will reach a wider audience.  Thanks.

[arbitrajeu]

Can you please help me understand what the Refresh Interval do in the RSS command (config.txt)?  Your reference says:

minimum time in seconds to refresh data when refresh button pressed / ActiveSync ends

Fishboy's response was excellent and comprehensive, as we have come to expect.  One thing he alluded to, but was not explicit on, is that this is actually the time in minutes, not seconds.

[pli7]

Thanks very much, Fishboy.

[fishboy]

You are welcome pli7, and thanks arbitrajeu, for the compliment and correction.  I have corrected the reference guide, which I hope to post in the next day or so after I get a few new commands ironed out.

[NickM]

fishboy,

is it possible to add 3 icons in widlist  

http://dark-mojo.com/TodayPlus/viewtopic.php?t=659

[fishboy]

is it possible to add 3 icons in widlist

Thanks for the update, they have been added.