Time, Attention, and Creative Work. After 4 years and a lot of productivity pr0n, we’re shifting gears. Re-learn how to use 43 Folders. Then back to work. [»]
”What’s 43 Folders?”
43Folders.com is Merlin Mann’s website about finding the time and attention to do your best creative work.
Newbie working with plain text: best practices for formatting etc?
Matthew Chagnon | Jan 22 2008
Hey all, I’ve searched far and wide online and am really surprised not to find very much info on this (perhaps I’m using the wrong search terms!). After reading Bit Literacy, I decided that I wanted to starting using plain text files more at work, especially for notes. Unfortunately, years of reading 43F has enhanced my fiddly nature, and I’m more focused on trying to format my notes “correctly,” or at least to have some sort of standard to stick to. Does anyone have any best practices (or web resources) for working with text on a page? Currently, I find text files difficult to read (and line breaks confusing). Any thoughts? 26 Comments
POSTED IN:
KISSSubmitted by Merlin Mann on January 22, 2008 - 5:59am.
Gee, thanks for the left-handed compliment. ;-) But, seriously, I think you answered your own question here. Whenever you look at planning stuff like this — and this goes for tagging, filing, or any other kind of organizational widgetizing — it’s worthwhile to ask yourself what any extra layer of organization buys you and when you’ll see that value. Examples. If a given text file is just a flat dump of lines (grocery list, ideas for future blog entries), then you probably need zero organization. Just keep appending new lines. If it’s still a flat dump, but chronology is important, same goes. Just append to the bottom and maybe add a date header to each section. I like Markdown, so mine might look like:
But then if you really need lots of organization inside the document, again, I’d go with Markdown or something similar that has syntax highlighting and semantic hooks inside your text editor of choice. E.G. when I write stuff in Markdown and use HTML “ Just don’t make this more complicated than it needs to be. Be crazy-consistent about how you name files (that’s huge), but I wouldn’t get too wound up about text formatting until patterns start to emerge from real-world usage. Then just go for consistency over fanciness. stuff that might help:»
TextmateSubmitted by dedalusjmmr on January 22, 2008 - 3:42pm.
Please note that the website for Textmate is http://macromates.com/ textmate.com goes to an advertising site :( »
Lifehacker and todo.txtSubmitted by rfquerin on January 22, 2008 - 6:43am.
Besides all the great stuff right here on 43F that Merlin mentions, there is a fair amount of good stuff on text files over at lifehacker.com. Personally I use Gina Trapani’s todo.txt (todotxt.com) system for task management. I’ve tried plenty of others but it’s the only one that has stuck for me. »
textSubmitted by pmenair on January 22, 2008 - 6:55am.
Org mode in emacs is nice for plain-text todo lists, scheduling, etc. One of the nice things that it does is it’s table-making ability - it gives you well-formatted, plain text “|” delimited tables, which you can easily import to Excel if you want. Or a database, for that matter. This is a nice solution to the classic trade-off between human readability and machine readability for structured data in plain text. Take a look at an xml file. Readable? Not so much. Not sure I understand what is confusing you about line breaks. Are you talking about the unix/mac/pc inconsistencies re what characters or sequences of characters indicate line breaks, or something else? »
another thing...Submitted by pmenair on January 22, 2008 - 6:57am.
More info about what you’re trying to do in plain text might help. I assume from the forum that you are trying to roll your own PIM, but more detail would help us come up with best practices recommendations. »
I use them almost exclusively for my business purposesSubmitted by gte910h on January 22, 2008 - 7:48am.
For my timelogs I keep in my consulting business (http://www.rowdylabs.com), I have three vim macros:
I then have a time tracking program (a quick python script you can email me at michael.langford@rowdylabs.com if you want it) that adds up all the time in a given text file. This allows me to bill clients accurately for hourly work, yet let them know I was doing things, and that I did take breaks off the clock and what they were. In those logs I often take notes on phone conversations as they’re happening as well. I usually do a format like: 1/22/2008 10:38:20 AM - START 1/22/2008 10:44:30 AM But I intentionally keep it a little messy so I don’t spend a lot of time reformatting it. It’s like when I scribble all over the front page of my moleskine when I get it so I can use the thing rather than going “oooh pretty paper” and “that thought isn’t good enough for that pretty paper” My web page is similarly generated from a template and plain text.
»
Mind posting your vim commands?Submitted by phrakture on January 22, 2008 - 12:45pm.
It’d be nice to take a look at the nitty-gritty, as this is similar to my approach, but I’ve been using :r!date, which is fugly »
Put this in your vimrcSubmitted by swaroop on February 5, 2008 - 6:18pm.
I use this:
»
text plusSubmitted by dbtodd on January 22, 2008 - 7:49am.
I used Text Edit (Tiger) for a long time, but do like to dress up the text also. Partly for functionality, partly because I have to look at it every day. I moved to using Bean (bean-osx.com) which adds more formatting tools on top of the Text Edit engine. You can tweak line spacing for example. Making a template is a good idea and very easy. »
Plain-text markupSubmitted by matt on January 22, 2008 - 7:52am.
If you’re looking for a system that works well for both reading plain-text and as markup for conversion to something prettier, I recommend reStructured Text. It’s heavily used in the Python programming community — lots of tools that can be very easily installed on OSX/Windows/Linux exist — and there’s even a handy website called rst2a that’ll accept it and spit back a PDF or HTML file of your text, completely beautified. (rst2a also accepts style sheets, if you don’t like any of their defaults.) »
About mjc |
|
| EXPLORE 43Folders | THE GOOD STUFF |