Reading other articles around the web IBM seems to have millions of documents and technical writers measured in the thousands.
Author: grant
Should You Learn More About The Text Encoding Initiative?
Brand new to me, looks great, and yes you should learn more about it. I will!
- Wikipedia page
-
What is TEI? (via Wikipedia)
The Text Encoding Initiative (TEI) is a text-centric community of practice in the academic field of digital humanities, operating continuously since the 1980s. The community currently runs a mailing list, meetings and conference series, and maintains the TEI technical standard, a journal,[1] a wiki, a GitHub repository and a toolchain.
- What’s it stored in? XML (via Wikipedia)
- Is there a journal? Yes (via Wikipedia)
- Are they on GitHub? Yes (via Wikipedia)
- Are there any samples? Yes lots of them (via Wikipedia). The TEI by Example project looks like a better place to start though
- What are some tool-chains for it? There are surely more but I ended up here on
- TextGrid which provides 4 interesting tools that bafflingly I can no longer find the link to.
- Anything particularly notable about TEI? Yes!
- “One Document Does it all (ODD) is a literate programming language for XML schemas.”
- “ODD is the format used internally by the Text Encoding Initiative for the TEI technical standard.”
Darwin Information Typing Architecture (DITA) In A Few Words
DITA is a philosophy for topic-oriented information management along with structured document data definitions for delivering it. It isn’t a general-purpose reusable technology like DocBook. Instead it focuses exclusively on creating a document model that best serves the diverse needs of your readers across different and equally valid scenarios.
A lumpier way to put it is that DocBook is to DITA as a chicken egg is to an omelet. You can’t unscramble an omelet, and when you figure out how, you shouldn’t! You can use DocBook to provide a DITA-like approach but you can’t use DITA to provide DocBook’s functionality.
How do DITA and DocBook compare? They don’t is how.
DocBook is an open-ended technology for designing anything. DITA is a focused technology for delivering a learning model.
An open standard created and maintained by self-sacrificing volunteers and BIG companies it is beloved, high-quality, and suffers the same ills and pangs of all human endeavors
DocBook In A Few Words
DocBook is a semantic markup language used to both define documents as structured data (and its elements ) along with explaining the meaning of those data (and its elements.)
The domain of the documen structured data is completely open and unlimited meant for 100% definition by the user.
It publishes to just about everything.
An open standard created and maintained by self-sacrificing volunteers and BIG companies it is beloved, high-quality, and suffers the same ills and pangs of all human endeavors
MkDocs: Project Documentation With Markdown
MkDocs is a fast, simple and downright gorgeous static site generator that’s geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file.
Looks like a nice static website generator.
Its intended for project documentation but looks fine for any topic based writing.
Let Vale Check Your Writing Style
Are you interested in automated writing assistance?
Space Ace For the Apple IIGS
Yes it is exactly the one that you are thinking.
Choosing Between Code and Verbatim Markup In Org Mode
Its helped me to standardize my approach to marking up techie language. Keeping it simple the content is either programming stuff or everything else tech related. Sufficiently vauge you see: I write down examples to keep it straight in my head. Here you go:
Continue reading “Choosing Between Code and Verbatim Markup In Org Mode”
How To Format USB Drive For A Printer Or Camera In macOS
Today I had to store a scanner’s scan onto a USB thumb drive. Unfortunately there weren’t any thumb drives sitting around that worked. Long story short I had to format the partition to be “device friendly.” What device do you ask? Cameras, printers, and scanners come to mind. What partition type are you wondering?
You might have easily guessed MS-DOS formatted. You might have easily forgotten like me it needs to be a MBR partition though. Doh!
WARNING: Unless you hold yourself responsible for the outcome don’t proceed.
Run diskutil list to see where your thumb drive is mounted.
Customize the command to specify the correct path now.
The command deletes everything on the drive and creates a single partition taking up the entire drive.
DOUBLE WARNING: IF YOU DO THIS WRONG YOU’LL LOSE ALL YOUR DATA!
The error would be specifying the wrong disk drive and poof your data is gone.
You seem to know what you are doing though.
Here is the command―you have to customize it for your thumb drive:
sudo diskutil partitionDisk <<<thumb drive name>>> MBR MS-DOS "PRINTORSCAN" "100%"
Configuring A Simple-Modeline
Customizing your Mode-Line is one step forward on every Emacser’s right of passage. Whether you use the informative yet quiet built-in Mode-Line or the visually stunning doom-modeline: you are finding the right porridge for you. Here is my choice―a simple halfway between those two―simple-modeline.
Its so great that I copied and pasted the options here. Alternately run customize or open simple-modeline-segments.el and occur simple-modeline-segment on it. Yup, that great.