Before Content


TABLE OF CONTENTS
     1. TXT-INDENT 1.
         1.1 Demo 1.1
     2. EDITING OF TXT DOCUMENT STRUCTURE AND CREATING INDEXED HTML VERSION 2.
         2.1 Introduction 2.1
         2.2 Who are the potential users 2.2
     3. CREATION OF CHAPTERS AND SUBCHAPTERS 3.
         3.1 Marking of chapters 3.1
         3.2 Numbering and renumbering of chapters 3.2
     4. INCLUDING WEB LINKS 4.
         4.1 Entering internal links with keyword tag look_at: 4.1
         4.2 Entering external links 4.2
     5. INCLUDING SIMPLE TABLES 5.
     6. CONVERSION TO HTML FORMAT AND INDEXING 6.
     7. CAPTURE TXT CONTENT FROM PDF, HTML AND OTHER FILES 7.
         7.1 Select all 7.1
         7.2 Copy 7.2
         7.3 Paste 7.3
         7.4 Web links 7.4
         7.5 UTF-8 7.5
         7.6 Copy file 7.6
         7.7 Starting the program 7.7
     8. DATA SECURITY AND PROTECTION OF USER PRIVACY 8.

END TABLE OF CONTENTS


Date of last change (yyyy-mm-dd): 2025.06.22


     1. TXT-INDENT
     An essential feature of the program is that it formats/reformats content by multi-level chapters and at
     the same time indexes it throughout the content.

     All our programs allow indexing and have a very useful interface that allows easy access to all-words index
     and further searches or navigation.
     The all-words index is accessible while reading, only by double-clicking on any word (full-text search).

     This interface and associated functionality are essential advantages over competing programs.

         1.1 Demo
         This website was designed and created according to the procedure described below.
         The draft file INDEX.TXT was processed with the TXT-INDENT program.
         The result of the processing is two output files:
         - index_indent.txt renamed to index.txt
         - index_indent.htm renamed to index.htm
         Output file in *.TXT format: http://www.txt-utilities.com/txt-indent/index.txt
         Output file in *.HTM format: http://www.txt-utilities.com/txt-indent/index.htm

         When starting the program, the indexing option was also selected, so the output file *.HTM is also indexed.
         Output indexed file in *.HTM format: http://www.txt-utilities.com/txt-indent/htm_ndx/htm_out/page_01.htm
         The index of all words can be accessed while reading indexed *.HTM file by double-clicking on any word.

         In addition to internal links, the program also generates Google search phrases which also point to the
         web address of the user's choice.

         Program, freeware version: http://www.txt-utilities.com/txt-indent/txt-indent.7z


     2. EDITING OF TXT DOCUMENT STRUCTURE AND CREATING INDEXED HTML VERSION

         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 indexed 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.
         But the file must not start with a chapter tag.

         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.
         The HTML file is indexed throughout the content and allows full-text search.
         You can access the all-words index by double-clicking on any word.
         look_at: 6.

         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.
         But the file must not start with a chapter tag.
         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.
         We suggest that you view them and also use them as input files for the program.


     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.

 

Internal tags for HTML tables

Internal tags (labels)	Description
Label table_start:	Label table_start: is a tag to start the table (HTML = < table >) followed by the data grouped by columns.
	Table-name (optional, table_start: table-name)
	Table-name is an additional parameter (HTML = < caption >)
	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:	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 = < th >)
	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:	Label align: is a tag that defines the alignment of data for the entire column.
	Possible values are: left, right, center
Label table_end:	Label table_end: is a tag to end the table (HTML = < /table >)
	ATTENTION, do not include HTML elements or related attributes in the draft document, and especially not in the table!

     6. CONVERSION TO HTML FORMAT AND INDEXING
     At the same time as creating a new TXT file structure, the program also creates an HTML output file.
     The HTML output document can also be indexed at the same time.
     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.
     The indexed HTML file is programmatically renamed and copied to the HTM_NDX/HTM_OUT subfolder.
     Indexing an HTML file is optional and is performed by the EXTERNAL program htm_ndx*.exe.
     You can also run the indexing program completely independently, but you must ensure that the program is
     in its own directory, and HTML files in the HTM_NDX/HTM_IN subdirectory.
     The indexed version of this website is available at:
     http://www.txt-utilities.com/txt-indent/htm_ndx/htm_out/page_01.htm


     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.

This document was structured using the TXT-INDENT program.
www.txt-utilities.com

Before Content