﻿
Date of last change (yyyy-mm-dd): 2025.08.27


    1. TXT-INDENT, indent_free
    
    The program is intended for editing the structure of a *.TXT document/file, and this document you are
    reading was also created with this program.
    <b>An essential feature of the program is that it formats/reformats content by multi-level chapters.</b>
    
    The indent_free program does not allow indexing for every word that has three (3) or more characters,
    this is a functionality only available in the freeware/paid version of the program.
    
    Program indent_free (free version): http://www.txt-utilities.com/txt-indent/indent-free/indent-free.7z
    
    2. EDITING OF TXT DOCUMENT STRUCTURE
    
        2.1 Introduction
        This program is intended for users who want to quickly and easily create a structured
        *.TXT file (document).
        At the same time as creating a new TXT file structure, the program also creates an HTML
        output file.
        The structure of the file is determined by the numbering of chapters and subchapters.
        The label of the first chapter in the file has a special meaning, as it defines the start level of
        all chapters.
        <b>But the file must not start with a chapter tag.</b>
        
        Almost any editor can be used to create such a file, MS NOTEPAD is also sufficient.
        It is highly recommended that TXT files be written in UTF-8 format.
        This instruction was created entirely using MS NOTEPAD and formatted with the Windows console
        program TXT-INDENT.
        
        2.2 Who are the potential users
        The program is intended for users who create relatively simple HTML files in terms of form and complex
        content in terms of content.
        The emphasis is on speed and transparency in creating such files.
        The users are therefore mainly analysts of various profiles, teachers and professors, and students.
        As a rule, structured documents are not created in one step, but go through multiple stages of
        supplementation and correction.
        Even if authors use editors that generate HTML code on the fly, consideration of the format is necessary
        from the very beginning.
        Changing the format required due to content changes is challenging and time consuming despite the use
        of HTML custom editors.
        The program we offer does not even try to compete with the mentioned editors, because it is minimalist
        in terms of HTML format elements, as the emphasis is on transparency and speed.
        
    3. CREATION OF CHAPTERS AND SUBCHAPTERS
    Chapters are marked exclusively by multilevel numbering.
    The format of this numbering is n1.n2.n3 ...
    
        3.1 Marking of chapters
        The chapters on the first level are marked n1. , a dot at the end is mandatory.
        The chapters of the second level are marked n1.n2, the third level n1.n2.n3 and so on.
        There is no dot for the last chapter numeric code, code n1.n2.n3. is wrong.
        The correct chapter designation on the third level is therefore n1.n2.n3 , without a dot at the end.
        The chapter label is followed by one or more spaces and the title of the chapter.
        The content of the chapter is written in the following lines under the chapter mark.
        The content of the chapter on the left edge is aligned with the chapter mark.
        Long lines of text are not printed separately, so they are not recommended.
        There are some such examples in this guide as well.
        Whole line spacing remains even after renumbering.
        
        3.2 Numbering and renumbering of chapters
        The label of the first chapter in the file has a special meaning, as it defines the start level of
        all chapters.
        <b>But the file must not start with a chapter tag.</b>
        It is highly recommended that TXT files be written in UTF-8 format.
        The level of the first chapter in the file MUST BE the first level labeled n1., but can also be n2,
        and so on.
        The essential functionality of the program is to renumber the chapters by levels and indent them
        accordingly.
        In this case, also the chapters marked as k1., l1 or m1. after renumbering, they stay first level,
        but submit to the number defined by the first chapter.
        So instead of k1. get the designation k2. or even k9.
        When users create chapters at the first and other levels (sub-levels), they often decide to arrange
        the chapters differently than they numbered at the beginning.
        Chapters of the first level are renumbered according to the position in the structure of the file
        (document).
        Other chapter level is determined by the current label, which changes depending on the position of
        the chapter in the file structure.
        For example, if a chapter has the designation n1.n2 (second-level chapter), it changes to k1.k2 or
        even l1.l2.l3...after renumbering.
        To illustrate the operation of the program, we have prepared some examples, files from case_01.txt to
        case_08.txt.
        
        View demo examples from case_01.txt to case_08.txt!
        
        
    4. INCLUDING WEB LINKS
    Incorporating internal and external (web) links is easy, but the work went into an HTML file.
    
        4.1 Entering internal links with keyword tag look_at:
        The internal link is marked with the keyword (internal tag) look_at: and must be written at the
        beginning of the line.
        This is followed by the space and mark (numbering) of the task, look_at: space number-of-task-(chapter)
        and no added text.
        look_at: 3.1
        
        4.2 Entering external links
        Web links are included in the rest of the document, as shown in the following example.
        The web address must be separated from the rest of the text, on the left and right, with at least
        one space.
        Therefore the dot at the end of the sentence must be separated from the web address.
        The name of the web address that will be displayed in the HTML document will be the web address itself.
        http://www.pdf-htm-ndx.info/knjiga_01/f000006.htm
        file:///E:/WEB_URL/PDF-HTM-NDX_INFO/knjiga_01/f000100.htm
        The easiest way to get the locator (address) of a document is to open it with a web browser.
        Then we copy the address from the browser navigation bar.
        
    5. INCLUDING SIMPLE TABLES
    Incorporating simple tables is easy, but the work went into an HTML file.
    HTML tables have a wide range of parameters (HTML elements and attributes) that define their properties.
    The program uses its tags to define a table, which, however, have their equivalents between HTML elements
    and attributes.
    The program uses only a few of the HTML elements and attributes listed below.
    
    Table_start: Internal tags for HTML tables
    
    Column: Internal tags (labels)
    
    Label table_start:
    
    
    
    
    
    Label column:
    
    
    
    
    
    
    
    
    
    Label align:
    
    
    Label table_end:
    
    Column: Description
    
    Label table_start: is a tag to start the table (HTML = &lt; table &gt;) followed by the data grouped by columns.
    Table-name (optional, table_start: table-name)
    Table-name is an additional parameter (HTML = &lt; caption &gt;)
    The name of the table is optional, it must be written together with table_start: (table_start: table-name),
    but with an intermediate mandatory space.
    
    Label column: is a tag to start the data group in the column.
    The sequence of columns is the same as the sequence of parameters column:.
    In the HTML table, the data will be displayed in rows, but in the source file they are grouped by columns for
    easier writing.
    
    Column-name (optional, column: column-name)
    Column-name is an additional parameter (HTML = &lt; th &gt;)
    The name of the column is optional, it must be written together with column: (column: column-name),
    but with an intermediate mandatory space.
    
    Label align: is a tag that defines the alignment of data for the entire column.
    Possible values are: left, right, center
    
    Label table_end: is a tag to end the table (HTML = &lt; /table &gt;)
    ATTENTION, do not include HTML elements or related attributes in the draft document, and especially not in the table!
    
    Table_end:
    
    6. CONVERSION TO HTML FORMAT
    At the same time as creating a new TXT file structure, the program also creates an HTML output file.
    To distinguish output TXT and HTML files from input files, an "_indent" extension is added to the name.
    The program does not offer output with the extension "_indent" in the list of possible input files at
    startup.
    If the user needs both a file and an input TXT file, he must copy and rename it.
    
    7. CAPTURE TXT CONTENT FROM PDF, HTML AND OTHER FILES
    Most users very often capture content from HTML documents (web pages).
    The sequence of commands for such capture is described below.
    
        7.1 Select all
        Right-clicking on the menu opens a menu from which you select "Select all".
        However, care must be taken not to be positioned on any object of the HTML page, otherwise the menu
        related to this object will be triggered.
        
        7.2 Copy
        You copy the content you marked with the "Copy" command.
        You can access the command from the menu that you also triggered by right-clicking.
        
        7.3 Paste
        The highlighted content must be placed (deposited) in the TXT document.
        As a rule, you have previously opened the corresponding TXT document with a text editor, or you
        are at the beginning of creating a new one.
        Almost every text editor also uses the TXT format to write their files, so you should have no
        problem with that.
        Even the simplest text editor like MS NOTEPAD is more than good enough.
        Download the copied content to a TXT document with the "Paste" command.
        
        7.4 Web links
        You can also include web links in a txt file if they are written in the form
        <a href="....."> ..... </a>
        and do not contain any spaces in the entire HTML element, from <a ... to ... </a> inclusive.
        
        7.5 UTF-8
        Save as UTF-8 code page.
        You must save the TXT file in the UTF-8 code page, which later ensures that all characters
        are printed correctly.
        
        7.6 Copy file
        The file must be copied to the same directory where the program is installed.
        
        7.7 Starting the program
        You run the program by double-clicking on its name in the File Manager or File Explorer file
        editor.
        
    8. DATA SECURITY AND PROTECTION OF USER PRIVACY
    The program does nothing that could compromise data security and user privacy.
