HPR4235: What Is Plain Text Programming?

Hacker Public Radio

Episode 3 - What Is A Plain Text Program? What Is A Plain Text Program? Today I'm going to go into more detail about what I mean when I say Plain Text Program. I want to emphasize that this is just me. Others may have different ideas on this topic. This is how I try to write Plain Text Programs. I will feature other people's work that I still consider to be Plain Text Programs that do not follow all of these guidelines. I want to thank the hosts on the monthly HPR Community News podcast for inspiring me. They had questions. I also want to thank those making comments. I'm new to Hacker Public Radio and I will try to be more timely responding to comments in the future. What Is A Plain Text File? Text files are usually edited in a text editor or in a word processor and saved with the .txt extension. They consist of a string of characters. Text files can be divided into lines using the newline character, n, or the carriage return and newline characters, rn. You don't have to type these characters. Your editor puts them in for you. Text files do not have to use the .txt extension. Most programming files, like .php or .c files are plain text. I will only be discussing programs that are open source and that store their code in text files. Plain text configuration files often have no extension. For my Plain Text Programs I use config.inc. There is no difference between text files and plain text files. People often say plain text files to distinguish them from word processor files like .doc or .odt files. Plain Text Programs use text files to store text like a title or a blog post. When I talk about Plain Text Programs I also mean something more than this. That's what this podcast is about. No Database? Plain Text Programs do not use a database like mysql or postgres. Also the file system does not imitate a database, creating keys, indexing, etc. Instead the file system performs the database functions by accessing files which can be text files, graphics files, or other files. These files can be all in one directory or in multiple directories in a single directory tree. If password security is required in a Plain Text Program that runs on the internet I make an exception to the single tree rule to allow passwords to be stored outside of the webspace. So the assets a Plain Text Program accesses are just files in the file system. No HTML Or Other Markup Required I have no rule against allowing html or other markup. But I do not assume that the maintainer knows how to do this or wants to learn it. The reason I started writing Plain Text Programs was to avoid html markup. I want to be able to type text files, save them, and upload them, without being concerned about anything except the text itself. The text files holding the content are written in block paragraph style with a blank line between paragraphs. Text files are not required in a Plain Text Program but most Plain Text Programs do use some text data which should be stored in text files. If this is a web application, links can be copied and pasted from the browser with no additional markup required. Other assets in the directory, like .gif, .jpg, or .png images, display automatically. I use the file names for meta data like title, caption, or sort order. I can also sort chronologically using the file timestamps. If there is a hierarchy of directories the program can use the directory name of the child directories for the link text. For instance the Delta Musicians directory tree can have a Table Of Contents at the top level that lists the musicians in alphabetical order. Each musician gets their own subdirectory and the na