Skip to content
This repository was archived by the owner on Feb 6, 2021. It is now read-only.

The construct

Cyrille Chopelet edited this page Jul 27, 2015 · 1 revision

What is the construct?

The time tracker is an Excel sheet but an Excel sheet is a binary. Git is better designed for text files, which an Excel file can be turned into, but editing an Excel file is easier using the software it was designed for.

The construct is just a tool to switch to and fro between the text files version (for pushing to Github) and the binary version (for easy editing).

The construct

You can download it via the link in the sidebar, to the right of this page.

How do I use it?

Running it

The construct is a runnable jar. It requires you to have โ˜• Java 7 or higher on your path. Double-clicking it should do the trick.

If you have problems with the double click, you can run the following command:

java -jar timetracker-construct.jar

๐Ÿ’ก You can put the jar inside the directory without risk. Keeping all in one place will make things easier.

Using it

  1. Set the directory you cloned the xls-time-tracker project to. You can type it into the text field or click the Folder button.
  2. Click the Construct Construct button to build the tracker.xlsx file from the files in xlsx_deconstructed (after a git pull for instance) or Deconstruct Deconstruct to go the other way (before a push). Just make sure there are no file locked before clicking (you typically want to close the Excel file).
  3. Presto!

Sweeping after it

If you are done contributing, you may wish to click Clear prefs Clear prefs before closing the construct one last time. This will remove the path to the project it has stored in your preferences. Small gain but if you are a maniac wanting to keep your machine clean, here is the way.

Contributing

The tracker is not the only thing you can contribute to.

You can head to the xls-time-tracker-construct repository to fork it if you want to enhance it (or adapt it to your own needs). The code is under MIT license, so feel free.

๐Ÿ“ˆ The tracker
Fork | Download

๐Ÿ“ฆ The construct
Fork | Download

Join the chat at https://gitter.im/cyChop/xls-time-tracker

Clone this wiki locally