diff options
| author | Zack Hobson | 2013-11-20 09:57:21 -0800 |
|---|---|---|
| committer | Zack Hobson | 2013-11-20 09:57:21 -0800 |
| commit | d0202009cb697b18365ae0fc9c0976b1c7f46785 (patch) | |
| tree | 09ebc5aaa5581793b33fb2b47e1ea98119651c1e | |
| parent | 9f526c1ce592a75fd0b9d8389435a065c70dd051 (diff) | |
| download | hcl-d0202009cb697b18365ae0fc9c0976b1c7f46785.tar.bz2 | |
Create gh-pages branch via GitHub
| -rw-r--r-- | index.html | 28 | ||||
| -rw-r--r-- | params.json | 2 |
2 files changed, 21 insertions, 9 deletions
@@ -29,7 +29,7 @@ </header> <section> <h1> -<a name="hcl" class="anchor" href="#hcl"><span class="octicon octicon-link"></span></a>HCl</h1> +<a name="harvest-command-line" class="anchor" href="#harvest-command-line"><span class="octicon octicon-link"></span></a>Harvest Command Line</h1> <p>HCl is a command-line tool for interacting with Harvest time sheets using the <a href="http://www.getharvest.com/api/time_tracking">Harvest time tracking API</a>.</p> @@ -40,23 +40,27 @@ <p>You can install hcl directly from rubygems.org:</p> <pre><code>$ gem install hcl -$ hcl show [date] </code></pre> -<p>or you can install from source using jeweler:</p> +<p>or you can install from source:</p> -<pre><code>$ gem install jeweler -$ rake install +<pre><code>$ rake install +</code></pre> + +<p>If you're using HCl for the first time, the show command sets up your +Harvest credentials:</p> + +<pre><code>$ hcl show </code></pre> <h2> <a name="usage" class="anchor" href="#usage"><span class="octicon octicon-link"></span></a>Usage</h2> -<pre><code>hcl [start] (@<task_alias> | <project_id> <task_id>) [+<time>] [<message>] +<pre><code>hcl [start] @<task_alias> [+<time>] [<message>] hcl note <message> hcl stop [message] hcl resume [@<task_alias>] -hcl log (@<task_alias> | <project_id> <task_id>) [+<time>] [<message>] +hcl log @<task_alias> [+<time>] [<message>] hcl show [date] hcl tasks hcl alias <task_alias> <project_id> <task_id> @@ -147,6 +151,14 @@ the same arguments as start:</p> <p>The above starts and immediately stops a one-hour timer with the given note.</p> <h3> +<a name="bash-auto-completion-of-task-aliases" class="anchor" href="#bash-auto-completion-of-task-aliases"><span class="octicon octicon-link"></span></a>Bash Auto-completion of Task Aliases</h3> + +<p>You can enable auto-completion of task aliases by adding this to your bashrc:</p> + +<pre><code>eval `hcl completion` +</code></pre> + +<h3> <a name="date-formats" class="anchor" href="#date-formats"><span class="octicon octicon-link"></span></a>Date Formats</h3> <p>Dates can be expressed in a variety of ways. See the <a href="http://chronic.rubyforge.org/">Chronic documentation</a> @@ -178,4 +190,4 @@ $ hcl show 1 week ago <script src="javascripts/scale.fix.js"></script> </body> -</html> +</html>
\ No newline at end of file diff --git a/params.json b/params.json index 3759d0e..0a57404 100644 --- a/params.json +++ b/params.json @@ -1 +1 @@ -{"name":"Hcl","tagline":"Command-line tool for manipulating Harvest timesheets","body":"# HCl\r\n\r\nHCl is a command-line tool for interacting with Harvest time sheets using the\r\n[Harvest time tracking API][htt].\r\n\r\n[htt]: http://www.getharvest.com/api/time_tracking\r\n\r\n## Quick Start\r\n\r\nYou can install hcl directly from rubygems.org:\r\n\r\n $ gem install hcl\r\n $ hcl show [date]\r\n\r\nor you can install from source using jeweler:\r\n\r\n $ gem install jeweler\r\n $ rake install\r\n\r\n## Usage\r\n\r\n hcl [start] (@<task_alias> | <project_id> <task_id>) [+<time>] [<message>]\r\n hcl note <message>\r\n hcl stop [message]\r\n hcl resume [@<task_alias>]\r\n hcl log (@<task_alias> | <project_id> <task_id>) [+<time>] [<message>]\r\n hcl show [date]\r\n hcl tasks\r\n hcl alias <task_alias> <project_id> <task_id>\r\n hcl aliases\r\n hcl (cancel | nvm | oops)\r\n\r\n### Available Projects and Tasks\r\n\r\nTo start a new timer you need to identify the project and task. After you've\r\nused the show command you can use the tasks command to view a cached list of\r\navailable tasks.\r\n\r\n $ hcl tasks\r\n\r\n### Starting a Timer\r\n\r\nSince it's not practical to enter two long numbers every time you want to\r\nidentify a task, HCl supports task aliases:\r\n\r\n $ hcl alias tacodev 1234 5678\r\n $ hcl @tacodev Adding a new feature\r\n\r\n### Starting a Timer with Initial Time\r\n\r\nYou can also provide an initial time when starting a new timer.\r\nThis can be expressed in floating-point or HH:MM. The following two\r\ncommands are equivalent:\r\n\r\n $ hcl @tacodev +0:15 Doing some stuff\r\n $ hcl +.25 @tacodev Doing some stuff\r\n\r\n### Adding Notes to a Running Task\r\n\r\nWhile a task is running you can append lines to the task notes:\r\n\r\n $ hcl note Then I did something else\r\n\r\n### Stopping a Timer\r\n\r\nThe following command will stop a running timer (currently only one timer at\r\na time is supported). You can provide a message when stopping a timer as\r\nwell:\r\n\r\n $ hcl stop All done doing things\r\n\r\n### Resuming a Timer\r\n\r\nYou can resume a stopped timer. Specify a task to resume the last timer\r\nfor that task:\r\n\r\n $ hcl resume\r\n $ hcl resume @xdev\r\n\r\n### Canceling a Timer\r\n\r\nIf you accidentally started a timer that you didn't mean to, you can cancel\r\nit:\r\n\r\n $ hcl cancel\r\n\r\nThis will delete the running timer, or the last-updated timer if one isn't\r\nrunning. You can also use `nvm` or `oops` instead of `cancel`.\r\n\r\n### Logging without Starting a Timer\r\n\r\nYou can log time and notes without leaving a timer running. It takes\r\nthe same arguments as start:\r\n\r\n $ hcl log @xdev +1 Worked for an hour.\r\n\r\nThe above starts and immediately stops a one-hour timer with the given note.\r\n\r\n### Date Formats\r\n\r\nDates can be expressed in a variety of ways. See the [Chronic documentation][cd]\r\nfor more information about available date input formats. The following\r\ncommands show the timesheet for the specified day:\r\n\r\n $ hcl show yesterday\r\n $ hcl show last friday\r\n $ hcl show 2 days ago\r\n $ hcl show 1 week ago\r\n\r\n[cd]: http://chronic.rubyforge.org/\r\n\r\n## Author\r\n\r\nHCl was designed and implemented by [Zack Hobson][zgh].\r\n\r\n* Non-SSL support by [Michael Bleigh][mbleigh].\r\n* Resume command by [Brian Cooke][bricooke].\r\n* UI improvements by [Chris Scharf][scharfie].\r\n\r\nSee LICENSE for copyright details.\r\n\r\n[zgh]: http://github.com/zenhob\r\n[mbleigh]: http://github.com/mbleigh\r\n[bricooke]: http://github.com/bricooke\r\n[scharfie]: http://github.com/scharfie\r\n\r\n\r\n\r\n","google":"","note":"Don't delete this file! It's used internally to help with page regeneration."}
\ No newline at end of file +{"name":"HCl","tagline":"Command-line tool for manipulating Harvest timesheets","body":"# Harvest Command Line\r\n\r\nHCl is a command-line tool for interacting with Harvest time sheets using the\r\n[Harvest time tracking API][htt].\r\n\r\n[htt]: http://www.getharvest.com/api/time_tracking\r\n\r\n## Quick Start\r\n\r\nYou can install hcl directly from rubygems.org:\r\n\r\n $ gem install hcl\r\n\r\nor you can install from source:\r\n\r\n $ rake install\r\n\r\nIf you're using HCl for the first time, the show command sets up your\r\nHarvest credentials:\r\n\r\n $ hcl show\r\n\r\n## Usage\r\n\r\n hcl [start] @<task_alias> [+<time>] [<message>]\r\n hcl note <message>\r\n hcl stop [message]\r\n hcl resume [@<task_alias>]\r\n hcl log @<task_alias> [+<time>] [<message>]\r\n hcl show [date]\r\n hcl tasks\r\n hcl alias <task_alias> <project_id> <task_id>\r\n hcl aliases\r\n hcl (cancel | nvm | oops)\r\n\r\n### Available Projects and Tasks\r\n\r\nTo start a new timer you need to identify the project and task. After you've\r\nused the show command you can use the tasks command to view a cached list of\r\navailable tasks.\r\n\r\n $ hcl tasks\r\n\r\n### Starting a Timer\r\n\r\nSince it's not practical to enter two long numbers every time you want to\r\nidentify a task, HCl supports task aliases:\r\n\r\n $ hcl alias tacodev 1234 5678\r\n $ hcl @tacodev Adding a new feature\r\n\r\n### Starting a Timer with Initial Time\r\n\r\nYou can also provide an initial time when starting a new timer.\r\nThis can be expressed in floating-point or HH:MM. The following two\r\ncommands are equivalent:\r\n\r\n $ hcl @tacodev +0:15 Doing some stuff\r\n $ hcl +.25 @tacodev Doing some stuff\r\n\r\n### Adding Notes to a Running Task\r\n\r\nWhile a task is running you can append lines to the task notes:\r\n\r\n $ hcl note Then I did something else\r\n\r\n### Stopping a Timer\r\n\r\nThe following command will stop a running timer (currently only one timer at\r\na time is supported). You can provide a message when stopping a timer as\r\nwell:\r\n\r\n $ hcl stop All done doing things\r\n\r\n### Resuming a Timer\r\n\r\nYou can resume a stopped timer. Specify a task to resume the last timer\r\nfor that task:\r\n\r\n $ hcl resume\r\n $ hcl resume @xdev\r\n\r\n### Canceling a Timer\r\n\r\nIf you accidentally started a timer that you didn't mean to, you can cancel\r\nit:\r\n\r\n $ hcl cancel\r\n\r\nThis will delete the running timer, or the last-updated timer if one isn't\r\nrunning. You can also use `nvm` or `oops` instead of `cancel`.\r\n\r\n### Logging without Starting a Timer\r\n\r\nYou can log time and notes without leaving a timer running. It takes\r\nthe same arguments as start:\r\n\r\n $ hcl log @xdev +1 Worked for an hour.\r\n\r\nThe above starts and immediately stops a one-hour timer with the given note.\r\n\r\n### Bash Auto-completion of Task Aliases\r\n\r\nYou can enable auto-completion of task aliases by adding this to your bashrc:\r\n\r\n eval `hcl completion`\r\n\r\n### Date Formats\r\n\r\nDates can be expressed in a variety of ways. See the [Chronic documentation][cd]\r\nfor more information about available date input formats. The following\r\ncommands show the timesheet for the specified day:\r\n\r\n $ hcl show yesterday\r\n $ hcl show last friday\r\n $ hcl show 2 days ago\r\n $ hcl show 1 week ago\r\n\r\n[cd]: http://chronic.rubyforge.org/\r\n\r\n## Author\r\n\r\nHCl was designed and implemented by [Zack Hobson][zgh].\r\n\r\n* Non-SSL support by [Michael Bleigh][mbleigh].\r\n* Resume command by [Brian Cooke][bricooke].\r\n* UI improvements by [Chris Scharf][scharfie].\r\n\r\nSee LICENSE for copyright details.\r\n\r\n[zgh]: http://github.com/zenhob\r\n[mbleigh]: http://github.com/mbleigh\r\n[bricooke]: http://github.com/bricooke\r\n[scharfie]: http://github.com/scharfie\r\n\r\n\r\n\r\n","google":"","note":"Don't delete this file! It's used internally to help with page regeneration."}
\ No newline at end of file |
