Sophie

Sophie

distrib > Mageia > 7 > armv7hl > media > core-release > by-pkgid > d8544620e4ac7bee48ddb48c85d55709 > files > 312

ikiwiki-3.20190228-1.mga7.noarch.rpm

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>taskreport (third party plugin)</title>
<meta name="viewport" content="width=device-width, initial-scale=1" />

<link rel="stylesheet" href="../../style.css" type="text/css" />

<link rel="stylesheet" href="../../local.css" type="text/css" />






<meta name="author" content="spalax" />



</head>
<body>

<div class="page">

<div class="pageheader">
<div class="header">
<span>
<span class="parentlinks">

<a href="../../index.html">ikiwiki</a>/ 

<a href="../../plugins.html">plugins</a>/ 

<a href="../contrib.html">contrib</a>/ 

</span>
<span class="title">
taskreport (third party plugin)

</span>
</span>



</div>









</div>





<div id="pagebody">

<div id="content" role="main">
<p><span class="infobox">
Plugin: taskreport<br />
Author: <span class="createlink">Louis</span><br />
Included in ikiwiki: no<br />
Enabled by default: no<br />
Included in <a href="../goodstuff.html">goodstuff</a>: no<br />
Currently enabled: no<br />
</span></p>

<h1>Taskreport</h1>

<p>The taskreport plugin provides the <code>task</code> directive (see below), displaying
<a href="http://taskwarrior.org">taskwarrior</a> data as a table.</p>

<h2>Plugin options</h2>

<ul>
<li><code>task_bin</code>: path to the task binary. Default is "task".</li>
<li><code>task_common</code>: arguments to all task calls. Can be used, for example, to set
a non-default taskrc location.</li>
<li><code>task_dir</code>: directory where to find task data files, if non-default. This
directory must be handled by IkiWiki. Otherwise, use the <code>task_common</code>
argument. This argument must be relative to the root of the wiki sources.</li>
<li><code>task_tmpdir</code>: directory where to copy task data files before calling task.
It can be used to circumvent <a href="https://bug.tasktools.org/browse/TW-204">lack of <code>--read-only</code>
option</a>. Otherwise, those data files may
be modified by the task call. Setting this directory ensure that they are
not. This argument should be absolute (I do not know what would happen
otherwise).</li>
<li><code>task_columns</code>: List of default columns to display with the
task directive. Default is all available columns.</li>
</ul>

<h2>Directive</h2>

<h3>Directive options</h3>

<p>Options are:</p>

<ul>
<li><code>arg</code>: arguments to add to the task call. For example, to display a list of
pending tasks tagged <code>ikiwiki</code>, set it to <code>"status:pending +ikiwiki"</code>.</li>
<li><code>show</code>: number of tasks to show. Default is 0, and means: print all tasks.</li>
<li><code>sort</code>: tasks are sorted according to this column. Default is <code>urgency</code>.</li>
<li><code>reverse</code>: set yes to reverse order.</li>
<li><code>annotations</code>: set to yes to display annotations. Default is "yes".</li>
</ul>

<h3>Task system call</h3>

<p>When using this directive, the result of the following system call is printed:</p>

<pre><code>TASK_BIN export rc.verbose=nothing TASK_COMMON [rc.data.location=DIR] ARG
</code></pre>

<ul>
<li><code>TASK_BIN</code> and <code>TASK_COMMON</code> are the <code>task_bin</code> and <code>task_common</code> options set in ikiwiki setup.</li>
<li>If <code>task_dir</code> and <code>task_tmpdir</code> are set in ikiwiki setup, <code>DIR</code> is <code>task_tmpdir</code> ; if only <code>task_dir</code> is set, <code>DIR</code> is <code>task_dir</code> ; otherwise, this part is not used.</li>
<li><code>ARG</code> is the <code>arg</code> option of the directive.</li>
</ul>

<h3>CSS</h3>

<p>To allow CSS customization, the following classes are used.</p>

<ul>
<li><code>task</code> is the class of the table.</li>
<li><code>urgency</code>, <code>project</code>, etc. are the class of the <code>th</code> and <code>td</code> elements for the corresponding task attributes.</li>
<li><code>annotation</code> is the class of the <code>tr</code> element of the table containing an annotation.</li>
</ul>

<h2>Download and install</h2>

<p>Code and documentation can be found here : <a href="https://atelier.gresille.org/projects/gresille-ikiwiki/wiki/Taskreport">https://atelier.gresille.org/projects/gresille-ikiwiki/wiki/Taskreport</a></p>

<p>-- <span class="createlink">Louis</span></p>

</div>







</div>

<div id="footer" class="pagefooter" role="contentinfo">

<div id="pageinfo">











<div class="pagedate">
Last edited <span class="date">Tue Feb 26 23:01:54 2019</span>
<!-- Created <span class="date">Tue Feb 26 23:01:54 2019</span> -->
</div>

</div>


<!-- from ikiwiki -->
</div>

</div>

</body>
</html>