summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZack Hobson2013-11-20 09:57:21 -0800
committerZack Hobson2013-11-20 09:57:21 -0800
commitd0202009cb697b18365ae0fc9c0976b1c7f46785 (patch)
tree09ebc5aaa5581793b33fb2b47e1ea98119651c1e
parent9f526c1ce592a75fd0b9d8389435a065c70dd051 (diff)
downloadhcl-d0202009cb697b18365ae0fc9c0976b1c7f46785.tar.bz2
Create gh-pages branch via GitHub
-rw-r--r--index.html28
-rw-r--r--params.json2
2 files changed, 21 insertions, 9 deletions
diff --git a/index.html b/index.html
index 99804e0..2cad157 100644
--- a/index.html
+++ b/index.html
@@ -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] (@&lt;task_alias&gt; | &lt;project_id&gt; &lt;task_id&gt;) [+&lt;time&gt;] [&lt;message&gt;]
+<pre><code>hcl [start] @&lt;task_alias&gt; [+&lt;time&gt;] [&lt;message&gt;]
hcl note &lt;message&gt;
hcl stop [message]
hcl resume [@&lt;task_alias&gt;]
-hcl log (@&lt;task_alias&gt; | &lt;project_id&gt; &lt;task_id&gt;) [+&lt;time&gt;] [&lt;message&gt;]
+hcl log @&lt;task_alias&gt; [+&lt;time&gt;] [&lt;message&gt;]
hcl show [date]
hcl tasks
hcl alias &lt;task_alias&gt; &lt;project_id&gt; &lt;task_id&gt;
@@ -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