1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 8.6.7" />
\r
7 <title>ptask README</title>
\r
8 <style type="text/css">
\r
9 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
\r
13 font-family: Georgia,serif;
\r
17 h1, h2, h3, h4, h5, h6,
\r
18 div.title, caption.title,
\r
19 thead, p.table.header,
\r
21 #author, #revnumber, #revdate, #revremark,
\r
23 font-family: Arial,Helvetica,sans-serif;
\r
27 margin: 1em 5% 1em 5%;
\r
32 text-decoration: underline;
\r
48 h1, h2, h3, h4, h5, h6 {
\r
51 margin-bottom: 0.5em;
\r
56 border-bottom: 2px solid silver;
\r
76 border: 1px solid silver;
\r
81 margin-bottom: 0.5em;
\r
87 ul > li { color: #aaa; }
\r
88 ul > li > * { color: black; }
\r
102 #revnumber, #revdate, #revremark {
\r
107 border-top: 2px solid silver;
\r
108 padding-top: 0.5em;
\r
113 padding-bottom: 0.5em;
\r
117 padding-bottom: 0.5em;
\r
122 margin-bottom: 1.5em;
\r
124 div.imageblock, div.exampleblock, div.verseblock,
\r
125 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
126 div.admonitionblock {
\r
128 margin-bottom: 1.5em;
\r
130 div.admonitionblock {
\r
132 margin-bottom: 2.0em;
\r
137 div.content { /* Block element content. */
\r
141 /* Block element titles. */
\r
142 div.title, caption.title {
\r
147 margin-bottom: 0.5em;
\r
153 td div.title:first-child {
\r
156 div.content div.title:first-child {
\r
159 div.content + div.title {
\r
163 div.sidebarblock > div.content {
\r
164 background: #ffffee;
\r
165 border: 1px solid #dddddd;
\r
166 border-left: 4px solid #f0f0f0;
\r
170 div.listingblock > div.content {
\r
171 border: 1px solid #dddddd;
\r
172 border-left: 5px solid #f0f0f0;
\r
173 background: #f8f8f8;
\r
177 div.quoteblock, div.verseblock {
\r
178 padding-left: 1.0em;
\r
179 margin-left: 1.0em;
\r
181 border-left: 5px solid #f0f0f0;
\r
185 div.quoteblock > div.attribution {
\r
186 padding-top: 0.5em;
\r
190 div.verseblock > pre.content {
\r
191 font-family: inherit;
\r
192 font-size: inherit;
\r
194 div.verseblock > div.attribution {
\r
195 padding-top: 0.75em;
\r
198 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
\r
199 div.verseblock + div.attribution {
\r
203 div.admonitionblock .icon {
\r
204 vertical-align: top;
\r
207 text-decoration: underline;
\r
209 padding-right: 0.5em;
\r
211 div.admonitionblock td.content {
\r
212 padding-left: 0.5em;
\r
213 border-left: 3px solid #dddddd;
\r
216 div.exampleblock > div.content {
\r
217 border-left: 3px solid #dddddd;
\r
218 padding-left: 0.5em;
\r
221 div.imageblock div.content { padding-left: 0; }
\r
222 span.image img { border-style: none; }
\r
223 a.image:visited { color: white; }
\r
227 margin-bottom: 0.8em;
\r
232 font-style: normal;
\r
235 dd > *:first-child {
\r
240 list-style-position: outside;
\r
243 list-style-type: decimal;
\r
246 list-style-type: lower-alpha;
\r
249 list-style-type: upper-alpha;
\r
252 list-style-type: lower-roman;
\r
255 list-style-type: upper-roman;
\r
258 div.compact ul, div.compact ol,
\r
259 div.compact p, div.compact p,
\r
260 div.compact div, div.compact div {
\r
262 margin-bottom: 0.1em;
\r
274 margin-bottom: 0.8em;
\r
277 padding-bottom: 15px;
\r
279 dt.hdlist1.strong, td.hdlist1.strong {
\r
283 vertical-align: top;
\r
284 font-style: normal;
\r
285 padding-right: 0.8em;
\r
289 vertical-align: top;
\r
291 div.hdlist.compact tr {
\r
297 background: yellow;
\r
300 .footnote, .footnoteref {
\r
304 span.footnote, span.footnoteref {
\r
305 vertical-align: super;
\r
309 margin: 20px 0 20px 0;
\r
310 padding: 7px 0 0 0;
\r
313 #footnotes div.footnote {
\r
319 border-top: 1px solid silver;
\r
328 padding-right: 0.5em;
\r
329 padding-bottom: 0.3em;
\r
330 vertical-align: top;
\r
332 div.colist td img {
\r
337 #footer-badges { display: none; }
\r
341 margin-bottom: 2.5em;
\r
349 margin-bottom: 0.1em;
\r
352 div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
369 span.aqua { color: aqua; }
\r
370 span.black { color: black; }
\r
371 span.blue { color: blue; }
\r
372 span.fuchsia { color: fuchsia; }
\r
373 span.gray { color: gray; }
\r
374 span.green { color: green; }
\r
375 span.lime { color: lime; }
\r
376 span.maroon { color: maroon; }
\r
377 span.navy { color: navy; }
\r
378 span.olive { color: olive; }
\r
379 span.purple { color: purple; }
\r
380 span.red { color: red; }
\r
381 span.silver { color: silver; }
\r
382 span.teal { color: teal; }
\r
383 span.white { color: white; }
\r
384 span.yellow { color: yellow; }
\r
386 span.aqua-background { background: aqua; }
\r
387 span.black-background { background: black; }
\r
388 span.blue-background { background: blue; }
\r
389 span.fuchsia-background { background: fuchsia; }
\r
390 span.gray-background { background: gray; }
\r
391 span.green-background { background: green; }
\r
392 span.lime-background { background: lime; }
\r
393 span.maroon-background { background: maroon; }
\r
394 span.navy-background { background: navy; }
\r
395 span.olive-background { background: olive; }
\r
396 span.purple-background { background: purple; }
\r
397 span.red-background { background: red; }
\r
398 span.silver-background { background: silver; }
\r
399 span.teal-background { background: teal; }
\r
400 span.white-background { background: white; }
\r
401 span.yellow-background { background: yellow; }
\r
403 span.big { font-size: 2em; }
\r
404 span.small { font-size: 0.6em; }
\r
406 span.underline { text-decoration: underline; }
\r
407 span.overline { text-decoration: overline; }
\r
408 span.line-through { text-decoration: line-through; }
\r
410 div.unbreakable { page-break-inside: avoid; }
\r
419 font-family: "Courier New", Courier, monospace;
\r
420 font-size: inherit;
\r
426 margin-bottom: 1.5em;
\r
428 div.tableblock > table {
\r
429 border: 3px solid #527bbd;
\r
431 thead, p.table.header {
\r
438 /* Because the table frame attribute is overriden by CSS in most browsers. */
\r
439 div.tableblock > table[frame="void"] {
\r
440 border-style: none;
\r
442 div.tableblock > table[frame="hsides"] {
\r
443 border-left-style: none;
\r
444 border-right-style: none;
\r
446 div.tableblock > table[frame="vsides"] {
\r
447 border-top-style: none;
\r
448 border-bottom-style: none;
\r
458 font-family: "Courier New", Courier, monospace;
\r
459 font-size: inherit;
\r
465 margin-bottom: 1.5em;
\r
467 thead, p.tableblock.header {
\r
476 border-spacing: 0px;
\r
477 border-style: solid;
\r
478 border-color: #527bbd;
\r
479 border-collapse: collapse;
\r
481 th.tableblock, td.tableblock {
\r
484 border-style: solid;
\r
485 border-color: #527bbd;
\r
488 table.tableblock.frame-topbot {
\r
489 border-left-style: hidden;
\r
490 border-right-style: hidden;
\r
492 table.tableblock.frame-sides {
\r
493 border-top-style: hidden;
\r
494 border-bottom-style: hidden;
\r
496 table.tableblock.frame-none {
\r
497 border-style: hidden;
\r
500 th.tableblock.halign-left, td.tableblock.halign-left {
\r
503 th.tableblock.halign-center, td.tableblock.halign-center {
\r
504 text-align: center;
\r
506 th.tableblock.halign-right, td.tableblock.halign-right {
\r
510 th.tableblock.valign-top, td.tableblock.valign-top {
\r
511 vertical-align: top;
\r
513 th.tableblock.valign-middle, td.tableblock.valign-middle {
\r
514 vertical-align: middle;
\r
516 th.tableblock.valign-bottom, td.tableblock.valign-bottom {
\r
517 vertical-align: bottom;
\r
527 padding-top: 0.5em;
\r
528 padding-bottom: 0.5em;
\r
529 border-top: 2px solid silver;
\r
530 border-bottom: 2px solid silver;
\r
533 border-style: none;
\r
535 body.manpage div.sectionbody {
\r
540 body.manpage div#toc { display: none; }
\r
543 <script type="text/javascript">
\r
545 var asciidoc = { // Namespace.
\r
547 /////////////////////////////////////////////////////////////////////
\r
548 // Table Of Contents generator
\r
549 /////////////////////////////////////////////////////////////////////
\r
551 /* Author: Mihai Bazon, September 2002
\r
552 * http://students.infoiasi.ro/~mishoo
\r
554 * Table Of Content generator
\r
557 * Feel free to use this script under the terms of the GNU General Public
\r
558 * License, as long as you do not remove or alter this notice.
\r
561 /* modified by Troy D. Hanson, September 2006. License: GPL */
\r
562 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
\r
564 // toclevels = 1..4.
\r
565 toc: function (toclevels) {
\r
567 function getText(el) {
\r
569 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
570 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
\r
572 else if (i.firstChild != null)
\r
573 text += getText(i);
\r
578 function TocEntry(el, text, toclevel) {
\r
581 this.toclevel = toclevel;
\r
584 function tocEntries(el, toclevels) {
\r
585 var result = new Array;
\r
586 var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
\r
587 // Function that scans the DOM tree for header elements (the DOM2
\r
588 // nodeIterator API would be a better technique but not supported by all
\r
590 var iterate = function (el) {
\r
591 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
592 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
\r
593 var mo = re.exec(i.tagName);
\r
594 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
\r
595 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
\r
605 var toc = document.getElementById("toc");
\r
610 // Delete existing TOC entries in case we're reloading the TOC.
\r
611 var tocEntriesToRemove = [];
\r
613 for (i = 0; i < toc.childNodes.length; i++) {
\r
614 var entry = toc.childNodes[i];
\r
615 if (entry.nodeName.toLowerCase() == 'div'
\r
616 && entry.getAttribute("class")
\r
617 && entry.getAttribute("class").match(/^toclevel/))
\r
618 tocEntriesToRemove.push(entry);
\r
620 for (i = 0; i < tocEntriesToRemove.length; i++) {
\r
621 toc.removeChild(tocEntriesToRemove[i]);
\r
624 // Rebuild TOC entries.
\r
625 var entries = tocEntries(document.getElementById("content"), toclevels);
\r
626 for (var i = 0; i < entries.length; ++i) {
\r
627 var entry = entries[i];
\r
628 if (entry.element.id == "")
\r
629 entry.element.id = "_toc_" + i;
\r
630 var a = document.createElement("a");
\r
631 a.href = "#" + entry.element.id;
\r
632 a.appendChild(document.createTextNode(entry.text));
\r
633 var div = document.createElement("div");
\r
634 div.appendChild(a);
\r
635 div.className = "toclevel" + entry.toclevel;
\r
636 toc.appendChild(div);
\r
638 if (entries.length == 0)
\r
639 toc.parentNode.removeChild(toc);
\r
643 /////////////////////////////////////////////////////////////////////
\r
644 // Footnotes generator
\r
645 /////////////////////////////////////////////////////////////////////
\r
647 /* Based on footnote generation code from:
\r
648 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
\r
651 footnotes: function () {
\r
652 // Delete existing footnote entries in case we're reloading the footnodes.
\r
654 var noteholder = document.getElementById("footnotes");
\r
658 var entriesToRemove = [];
\r
659 for (i = 0; i < noteholder.childNodes.length; i++) {
\r
660 var entry = noteholder.childNodes[i];
\r
661 if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
\r
662 entriesToRemove.push(entry);
\r
664 for (i = 0; i < entriesToRemove.length; i++) {
\r
665 noteholder.removeChild(entriesToRemove[i]);
\r
668 // Rebuild footnote entries.
\r
669 var cont = document.getElementById("content");
\r
670 var spans = cont.getElementsByTagName("span");
\r
673 for (i=0; i<spans.length; i++) {
\r
674 if (spans[i].className == "footnote") {
\r
676 var note = spans[i].getAttribute("data-note");
\r
678 // Use [\s\S] in place of . so multi-line matches work.
\r
679 // Because JavaScript has no s (dotall) regex flag.
\r
680 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
\r
681 spans[i].innerHTML =
\r
682 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
\r
683 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
684 spans[i].setAttribute("data-note", note);
\r
686 noteholder.innerHTML +=
\r
687 "<div class='footnote' id='_footnote_" + n + "'>" +
\r
688 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
\r
689 n + "</a>. " + note + "</div>";
\r
690 var id =spans[i].getAttribute("id");
\r
691 if (id != null) refs["#"+id] = n;
\r
695 noteholder.parentNode.removeChild(noteholder);
\r
697 // Process footnoterefs.
\r
698 for (i=0; i<spans.length; i++) {
\r
699 if (spans[i].className == "footnoteref") {
\r
700 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
\r
701 href = href.match(/#.*/)[0]; // Because IE return full URL.
\r
703 spans[i].innerHTML =
\r
704 "[<a href='#_footnote_" + n +
\r
705 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
711 install: function(toclevels) {
\r
714 function reinstall() {
\r
715 asciidoc.footnotes();
\r
717 asciidoc.toc(toclevels);
\r
721 function reinstallAndRemoveTimer() {
\r
722 clearInterval(timerId);
\r
726 timerId = setInterval(reinstall, 500);
\r
727 if (document.addEventListener)
\r
728 document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
\r
730 window.onload = reinstallAndRemoveTimer;
\r
734 asciidoc.install(2);
\r
738 <body class="article">
\r
740 <h1>ptask README</h1>
\r
742 <div id="toctitle">Table of Contents</div>
743 <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
747 <div class="sect1">
\r
748 <h2 id="_introduction">1. Introduction</h2>
\r
749 <div class="sectionbody">
\r
750 <div class="paragraph"><p><tt>ptask</tt> is a GTK+ graphical user interface of <tt>taskwarrior</tt>, a command
\r
751 line tasks manager.</p></div>
\r
754 <div class="sect1">
\r
755 <h2 id="_installation_using_distribution_packages">2. Installation Using Distribution Packages</h2>
\r
756 <div class="sectionbody">
\r
757 <div class="sect2">
\r
758 <h3 id="_ubuntu">2.1. Ubuntu</h3>
\r
759 <div class="paragraph"><p>To install <tt>ptask</tt>, the easiest way is to use the dedicated PPA:</p></div>
\r
760 <div class="listingblock">
\r
761 <div class="content">
\r
762 <pre><tt>sudo apt-add-repository ppa:jfi/ptask
\r
763 sudo apt-get update
\r
764 sudo apt-get install ptask</tt></pre>
\r
769 <div class="sect1">
\r
770 <h2 id="_installation_from_source_archive">3. Installation From Source Archive</h2>
\r
771 <div class="sectionbody">
\r
772 <div class="paragraph"><p><tt>ptask</tt> can be compiled and installed on any modern GNU/Linux
\r
773 distribution.</p></div>
\r
774 <div class="sect2">
\r
775 <h3 id="_compilation_prerequisites">3.1. Compilation Prerequisites</h3>
\r
776 <div class="paragraph"><p>The compilation of <tt>ptask</tt> requires:</p></div>
\r
777 <div class="ulist"><ul>
\r
785 cppcheck (optional, static source checker)
\r
814 <div class="paragraph"><p>For Ubuntu 12.10:</p></div>
\r
815 <div class="listingblock">
\r
816 <div class="content">
\r
817 <pre><tt>sudo apt-get install autoconf automake asciidoc cppcheck gcc gettext
\r
818 autopoint help2man libgtk-3-dev libjson0-dev make perl</tt></pre>
\r
823 <div class="sect1">
\r
824 <h2 id="_contact">4. Contact</h2>
\r
825 <div class="sectionbody">
\r
826 <div class="paragraph"><p>Bugs and comments can be sent to <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p></div>
\r
827 <div class="paragraph"><p>Home page: <a href="http://wpitchoune.net/ptask">http://wpitchoune.net/ptask</a></p></div>
\r
828 <div class="paragraph"><p>Release changes: <a href="NEWS.html">NEWS</a></p></div>
\r
832 <div id="footnotes"><hr /></div>
\r
834 <div id="footer-text">
\r
835 Last updated 2012-12-11 09:03:53 CET
\r