mirror of
https://github.com/GothenburgBitFactory/taskwarrior.git
synced 2025-06-26 10:54:26 +02:00
708995093b
- Removed unnecessary usage.html links from other pages. - Added new sequence.html page to describe how to use ID sequences.
157 lines
5.5 KiB
HTML
157 lines
5.5 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<title>Data Import</title>
|
|
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
|
<link rel="stylesheet" href="task.css" type="text/css" />
|
|
</head>
|
|
|
|
<body>
|
|
<div id="container">
|
|
<table>
|
|
<tr>
|
|
<td>
|
|
<div id="toolbar">
|
|
<a href="task.html">Home</a>
|
|
<a href="setup.html">Setup</a>
|
|
<a href="30second.html">30-second Tutorial</a>
|
|
<a href="simple.html">Simple</a>
|
|
<a href="advanced.html">Advanced</a>
|
|
<a href="shell.html">Shell</a>
|
|
<a href="config.html">Configuration</a>
|
|
<a href="color.html">Colors</a>
|
|
<a href="recur.html">Recurrence</a>
|
|
<a href="date.html">Date Handling</a>
|
|
<a href="faq.html">FAQ</a>
|
|
<a href="versions.html">Old Versions</a>
|
|
<a href="links.html">Task on the Web</a>
|
|
</div>
|
|
|
|
<div id="content">
|
|
<br />
|
|
<br />
|
|
<br />
|
|
<h2 class="title">Data Import</h2>
|
|
<div class="content">
|
|
<p>
|
|
Tasks can be imported from files with this command:
|
|
|
|
<pre><code>% task import file</code></pre>
|
|
|
|
A variety of different file types are recognized by task, namely:
|
|
|
|
<ul>
|
|
<li>Tasks exported from task prior to version 1.5.0.
|
|
<li>Tasks exported from task version 1.5.0 and later. The file
|
|
format changed with 1.5.0.
|
|
<li>todo.sh files.
|
|
<li>CSV files with a variety of recognized column names.
|
|
<li>Plain text files, with one task listed per line.
|
|
<li>Task command line format.
|
|
</ul>
|
|
</p>
|
|
|
|
<p>
|
|
Task makes a good effort to determine which of these formats a
|
|
file is. It does this by reading the file, and looking for
|
|
familiar patterns. For example, the easiest files to recognize
|
|
are those exported from task itself, because they all have a
|
|
header line that comes in only three variations. Other formats
|
|
are a little harder to identify, but they all have their own
|
|
identifying characteristics.
|
|
</p>
|
|
|
|
<p>
|
|
The most complex import is when a CSV file is recognized.
|
|
Task needs a field header line in order to map columns to task
|
|
data items. For example, the if the following file is
|
|
imported:
|
|
</p>
|
|
|
|
<pre><code>number,status,task
|
|
1,pending,task one
|
|
2,pending,task two</code></pre>
|
|
|
|
<p>
|
|
Task will map the "number" field to task's "id" field, etc,
|
|
based on name. Task has a list of synonyms that it uses to
|
|
map fields, but you can specify your own override with any of
|
|
the following configuration variables:
|
|
</p>
|
|
|
|
<ul>
|
|
<li>import.synonym.id
|
|
<li>import.synonym.uuid
|
|
<li>import.synonym.status
|
|
<li>import.synonym.tags
|
|
<li>import.synonym.entry
|
|
<li>import.synonym.start
|
|
<li>import.synonym.due
|
|
<li>import.synonym.recur
|
|
<li>import.synonym.end
|
|
<li>import.synonym.project
|
|
<li>import.synonym.priority
|
|
<li>import.synonym.fg
|
|
<li>import.synonym.bg
|
|
<li>import.synonym.description
|
|
</ul>
|
|
|
|
<p>
|
|
Please note that it is wise to backup your task data files
|
|
before an import.
|
|
</p>
|
|
</div>
|
|
|
|
<br />
|
|
<br />
|
|
<div class="content">
|
|
<p>
|
|
Copyright 2006-2009, P. Beckingham. All rights reserved.
|
|
</p>
|
|
</div>
|
|
|
|
</div>
|
|
</td>
|
|
|
|
<td align="right" valign="top" width="200px">
|
|
<br />
|
|
<br />
|
|
<br />
|
|
<br />
|
|
<br />
|
|
<br />
|
|
<br />
|
|
<br />
|
|
<br />
|
|
<br />
|
|
|
|
<script type="text/javascript"><!--
|
|
google_ad_client = "pub-9709799404235424";
|
|
/* Task Main */
|
|
google_ad_slot = "8660617875";
|
|
google_ad_width = 120;
|
|
google_ad_height = 600;
|
|
//-->
|
|
</script>
|
|
<script type="text/javascript"
|
|
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
|
|
</script>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<script type="text/javascript">
|
|
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
|
|
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
|
|
</script>
|
|
<script type="text/javascript">
|
|
var pageTracker = _gat._getTracker("UA-4737637-1");
|
|
pageTracker._initData();
|
|
pageTracker._trackPageview();
|
|
</script>
|
|
|
|
</body>
|
|
</html>
|
|
|