Utags, is the first module of TextOffice.

2.Utags inf

Utags is a program that allows through the use of . langage de balisage leger mentor  manage a hypertext database, i.e. the management of your texts of any nature: documentation, source code, parameter files, etc....

Utags is a tool that integrates with the gvim editor(vim) cf vim_org by producing a "tags" file named utags (for universal label list) which is an index allowing hypertext navigation.

After creating this tool, I realized that to master its power, I had to develop a methodology.

I called this methodology "mentor" because it is a great help for a quick access to information and for its organization (which is corollary).

The mentor approach is a combination of information physics principles (entropie) and the unix spirit.

Gvim is the GUI that allows to use utags.

A vim "Utags" menu gathers all the mentor hypertext management commands in gvim, this menu is essentially tutorial to allow you to get the hang of it but with time you will not need to use the menu for the usual commands.

2.1. Uploading utags

The first version of utags is a betatest version available on linux 64 bits.

Installable by the debian installer. Cf debian_org.

Download link : The present version is the French version, the English version will be available soon.

Download the debian utags installer for Linux 64bits

Installation instructions can be found in readme_utags_txh_en Once installed gvim will open directly on the mentor source document of the. aide utags  where you can start learning how to use utags.

3.Utags prs

Often you wanted to write down an idea, wanted to record somewhere a piece of information that would be useful later, or a link to explore later.
Or you have spent an hour exploring a source code to find out where and how to make that change right.
And then either you didn't do it because you didn't know where to store that idea, that information, so you could just find it.
Or maybe you wrote it down on a piece of paper, or better a notebook or a file and then you lost the paper forgot to consult and update the notebook, you don't even know where it is anymore and forgot where the damn file or files were because you tried to organize by theme etc..
And then it's time consuming to click several times to open the right subdirectory where the file is located and then search for it, etc, etc, etc..
In short, because it was not practical, immediate and effective, after several attempts you gave up spending energy and time unnecessarily for it.
But you are dissatisfied with it.
And for the developers, your navigation in the source code, by dint of concentration, allowed you to make this modification of the code but then you didn't record, take notes on what you learned by exploring the sources, which is called retro-documentation and in a month or six you'll have to do this exploration again because you'll have forgotten 90 e this work.
In the same way, you feel helpless when faced with undocumented source code or with documentation that you cannot trust because of the mismatch with the source, if you are lucky or unlucky enough that it exists.
I have of course been confronted with all these situations and that is why I have built this tool that I have been using for about 25 years and that I am putting at your disposal today.
Utags is the tool that allowed me to save any useful information quickly, to easily reorganize the saved information and to find in a few seconds a piece of information that is several years old.
Wonderful, you might say ! Yes, but there is a small downside : To access this valuable tool, there is a sesame that may be a little expensive for you unless you have already adopted it: if you use the gvim/vim cf text editor vim_org But believe me : it's worth it, you can't imagine your return on investment because you will live in another world.
A . aide vim  is provided to help you get started with the editor.
Utags organizes a hypertext database using the mentor methodology ( cf . mentor prs 1  ) allowing you to enter the field of hypertext editing.
Don't edit text, edit hypertext ! Mentor applies to unstructured data (textual) the same principle of separation of data and presentation layers that is generally applied to structured data (database) The presentation layer is provided by the utility that allows the generation of HTML pages that produced the pages of this site and the site quantique_org However, structured data tables are already present in utags in the form of text blocks in CSV format with a utility for formatting tables.
Eventually, Utags will integrate the functions expected in an office suite by integrating structured data (relational database and spreadsheet) from utilities that manipulate CSV tables to perform calculations and relational functions between the different tables.
In reality I have been using these CSV functions for structured data for years but I have a big project to make it a distributable product.
. soutien site textoffice