Skip to main content

Does software exist to easily markup techinicaltechnical documents as audio scripts?

Inspired by this question: Is there a need for better software for writers? I have an IDE1¹ related question about software that can assist writers.

Is there a tool to (easily) turn technical writing into a narration script?

I'm making DAISY2² documents from Word files. The text can contain multiple ugly sentences, and I often find myself marking them up oddly to create a human-pronounceable versions. The technical document and the audiobook/HTML version use the same words (except things like "e.g." becoming "for example"), but the mega-sentences are hard to parse. Some of my edits are standard, and I'm only noting them to be able to find-and-replace them later.

What I would like the software to be able to do:

  • Mark text as belonging to a certain category. For example:
    • This is an on-screen phrasing
    • This is the 'noun' of the sentence
  • Apply special conditions for definable lists of keywords. For example:
    • Treat words in this list as 'end-noun-phrases'
    • Treat words in this list as adjectival screen terminology.

I can visualize how I would like the software to work; dragging a phrase to a "resource" pane to mark it as a specific type that should then be highlighted/marked a certain way. I just have no idea how to do it, besides my manual mark-up.

I can see a tool like this being useful for anyone who creates online-learning from technical writing, not just my very specific scenario. (At my job we create the sync-able HTML using Dolphin Publisher, we record the audio, and then they get synched.)


1 ¹ Integrated Development Environment - Collective term for the editing software used by programmers. Common features include; keyword/syntax highlighting and auto-completion.

2 ² DAISY is a standard for multimedia books, often navigate-able audio books, created for accessibility purposes. Because text is highlighted as it is spoken, it's also great for dyslexics. It's a little more flexible than an audiobook, but for my purposes, it's basically an audiobook with a visible HTML side.

Does software exist to easily markup techinical documents as audio scripts?

Inspired by this question: Is there a need for better software for writers? I have an IDE1 related question about software that can assist writers.

Is there a tool to (easily) turn technical writing into a narration script?

I'm making DAISY2 documents from Word files. The text can contain multiple ugly sentences, and I often find myself marking them up oddly to create a human-pronounceable versions. The technical document and the audiobook/HTML version use the same words (except things like "e.g." becoming "for example"), but the mega-sentences are hard to parse. Some of my edits are standard, and I'm only noting them to be able to find-and-replace them later.

What I would like the software to be able to do:

  • Mark text as belonging to a certain category. For example:
    • This is an on-screen phrasing
    • This is the 'noun' of the sentence
  • Apply special conditions for definable lists of keywords. For example:
    • Treat words in this list as 'end-noun-phrases'
    • Treat words in this list as adjectival screen terminology.

I can visualize how I would like the software to work; dragging a phrase to a "resource" pane to mark it as a specific type that should then be highlighted/marked a certain way. I just have no idea how to do it, besides my manual mark-up.

I can see a tool like this being useful for anyone who creates online-learning from technical writing, not just my very specific scenario. (At my job we create the sync-able HTML using Dolphin Publisher, we record the audio, and then they get synched.)


1 Integrated Development Environment - Collective term for the editing software used by programmers. Common features include; keyword/syntax highlighting and auto-completion.

2 DAISY is a standard for multimedia books, often navigate-able audio books, created for accessibility purposes. Because text is highlighted as it is spoken, it's also great for dyslexics. It's a little more flexible than an audiobook, but for my purposes, it's basically an audiobook with a visible HTML side.

Does software exist to easily markup technical documents as audio scripts?

Inspired by this question: Is there a need for better software for writers? I have an IDE¹ related question about software that can assist writers.

Is there a tool to (easily) turn technical writing into a narration script?

I'm making DAISY² documents from Word files. The text can contain multiple ugly sentences, and I often find myself marking them up oddly to create a human-pronounceable versions. The technical document and the audiobook/HTML version use the same words (except things like "e.g." becoming "for example"), but the mega-sentences are hard to parse. Some of my edits are standard, and I'm only noting them to be able to find-and-replace them later.

What I would like the software to be able to do:

  • Mark text as belonging to a certain category. For example:
    • This is an on-screen phrasing
    • This is the 'noun' of the sentence
  • Apply special conditions for definable lists of keywords. For example:
    • Treat words in this list as 'end-noun-phrases'
    • Treat words in this list as adjectival screen terminology.

I can visualize how I would like the software to work; dragging a phrase to a "resource" pane to mark it as a specific type that should then be highlighted/marked a certain way. I just have no idea how to do it, besides my manual mark-up.

I can see a tool like this being useful for anyone who creates online-learning from technical writing, not just my very specific scenario. (At my job we create the sync-able HTML using Dolphin Publisher, we record the audio, and then they get synched.)


¹ Integrated Development Environment - Collective term for the editing software used by programmers. Common features include; keyword/syntax highlighting and auto-completion.

² DAISY is a standard for multimedia books, often navigate-able audio books, created for accessibility purposes. Because text is highlighted as it is spoken, it's also great for dyslexics. It's a little more flexible than an audiobook, but for my purposes, it's basically an audiobook with a visible HTML side.

major re-write to remove unnessary information and clarify the question
Source Link
linksassin
  • 4.2k
  • 3
  • 24
  • 52

Writing Software: Is anything (like an IDE) Does software exist to convert technical writing intoeasily markup techinical documents as audio scripts?

Inspired by this question: Is there a need for better software for writers? I have an IDE-related1 related question about software that can assist writers -- Is there a tool to (easily) turn technical writing into a narration script?.


*IDE = Integrated Development Environment-- programmers "type" just like writers, but they're using language differently, and their tool reflects that specific words have specific functions. If I use NotePad++ for example, a word like "print" lights up one way, to indicate it's a command, and html tags light up differently than an html option, etc.*

Is there a tool to (easily) turn technical writing into a narration script?

I'm making DAISY2 documents from Word files, and since we have. The text can contain multiple ugly sentences, and I often find myself marking them up oddly to create a human-sayable version


*DAISY is a standard for multimedia books, often navigate-able audio books, created for accessibility purposes. Because text is highlighted as it is spoken, it's also great for dyslexics. It's a little more flexible than an audiobook, but for my purposes, it's basically an audiobook with a visible HTML side.*

Thepronounceable versions (technical full. The technical document and the audiobook/HTML version use the same words (except things like e"e.g." becoming "for example"), but the mega-sentences are hard to parse.

I'd love to be able to semi-automate marking "this is an on-screen phrasing" and "this is the 'noun' of the sentence.

Press ALT+1 to move to the Region Search Case ID, Last Name, SSN edit field, and then type in the new search terms.

(That's the middle of a sentence. If you think of it as "Press ALT+1 to move to the Red Square", then "region...ssn" is red, and "edit field" is square.)

Some Some of my edits are standard, and I'm only noting them to control-H (findbe able to find-and-replace) them -- marking out the F in a function key (F7) so I don't just say "7", and underlining the "not"slater.

ButWhat I would lovelike the software to also be able to say "treat words in this list as 'end-noun-phrases' " (square) and and "treat words in this list as adjectival screen terminology." (Within a given document, there tend to just be a relatively limited set of these.)do:

  • Mark text as belonging to a certain category. For example:
    • This is an on-screen phrasing
    • This is the 'noun' of the sentence
  • Apply special conditions for definable lists of keywords. For example:
    • Treat words in this list as 'end-noun-phrases'
    • Treat words in this list as adjectival screen terminology.

I could picture incan visualize how I would like the IDE,software to work; dragging a phrase to a "resource" pane, to mark it as a specific type that should then be highlighted/marked a certain way.

Just I just have no idea how to do it, besides my manual mark mark-up.

I can see a tool like this being useful for anyone who creates online-learning from technical writing, not just my very specific scenario. (At my job we create the sync-able HTML using Dolphin PublisherDolphin Publisher, we record the audio, and then they get synched.)


  
Inspired by this question: https://writing.stackexchange.com/questions/45035/is-there-a-need-for-better-software-for-writers

1 Integrated Development Environment - Collective term for the editing software used by programmers. Common features include; keyword/syntax highlighting and auto-completion.

2 DAISY is a standard for multimedia books, often navigate-able audio books, created for accessibility purposes. Because text is highlighted as it is spoken, it's also great for dyslexics. It's a little more flexible than an audiobook, but for my purposes, it's basically an audiobook with a visible HTML side.

Writing Software: Is anything (like an IDE) to convert technical writing into audio scripts?

I have an IDE-related question about software that can assist writers -- Is there a tool to (easily) turn technical writing into a narration script?


*IDE = Integrated Development Environment-- programmers "type" just like writers, but they're using language differently, and their tool reflects that specific words have specific functions. If I use NotePad++ for example, a word like "print" lights up one way, to indicate it's a command, and html tags light up differently than an html option, etc.*

I'm making DAISY documents from Word files, and since we have ugly sentences, I find myself marking them up oddly to create a human-sayable version


*DAISY is a standard for multimedia books, often navigate-able audio books, created for accessibility purposes. Because text is highlighted as it is spoken, it's also great for dyslexics. It's a little more flexible than an audiobook, but for my purposes, it's basically an audiobook with a visible HTML side.*

The versions (technical full document and the audiobook/HTML version use the same words (except things like e.g. becoming "for example"), but the mega-sentences are hard to parse.

I'd love to be able to semi-automate marking "this is an on-screen phrasing" and "this is the 'noun' of the sentence.

Press ALT+1 to move to the Region Search Case ID, Last Name, SSN edit field, and then type in the new search terms.

(That's the middle of a sentence. If you think of it as "Press ALT+1 to move to the Red Square", then "region...ssn" is red, and "edit field" is square.)

Some of my edits are standard, and I'm noting them to control-H (find-and-replace) them -- marking out the F in a function key (F7) so I don't just say "7", and underlining the "not"s.

But I would love to also be able to say "treat words in this list as 'end-noun-phrases' " (square) and and "treat words in this list as adjectival screen terminology." (Within a given document, there tend to just be a relatively limited set of these.)

I could picture in the IDE, dragging a phrase to a "resource" pane, to mark it as a specific type that should then be highlighted/marked a certain way.

Just no idea how to do it, besides my manual mark-up.

I can see a tool like this being useful for anyone who creates online-learning from technical writing, not just my very specific scenario. (At my job we create the sync-able HTML using Dolphin Publisher, we record the audio, and then they get synched.)


  Inspired by this question: https://writing.stackexchange.com/questions/45035/is-there-a-need-for-better-software-for-writers

Does software exist to easily markup techinical documents as audio scripts?

Inspired by this question: Is there a need for better software for writers? I have an IDE1 related question about software that can assist writers.

Is there a tool to (easily) turn technical writing into a narration script?

I'm making DAISY2 documents from Word files. The text can contain multiple ugly sentences, and I often find myself marking them up oddly to create a human-pronounceable versions. The technical document and the audiobook/HTML version use the same words (except things like "e.g." becoming "for example"), but the mega-sentences are hard to parse. Some of my edits are standard, and I'm only noting them to be able to find-and-replace them later.

What I would like the software to be able to do:

  • Mark text as belonging to a certain category. For example:
    • This is an on-screen phrasing
    • This is the 'noun' of the sentence
  • Apply special conditions for definable lists of keywords. For example:
    • Treat words in this list as 'end-noun-phrases'
    • Treat words in this list as adjectival screen terminology.

I can visualize how I would like the software to work; dragging a phrase to a "resource" pane to mark it as a specific type that should then be highlighted/marked a certain way. I just have no idea how to do it, besides my manual mark-up.

I can see a tool like this being useful for anyone who creates online-learning from technical writing, not just my very specific scenario. (At my job we create the sync-able HTML using Dolphin Publisher, we record the audio, and then they get synched.)

 

1 Integrated Development Environment - Collective term for the editing software used by programmers. Common features include; keyword/syntax highlighting and auto-completion.

2 DAISY is a standard for multimedia books, often navigate-able audio books, created for accessibility purposes. Because text is highlighted as it is spoken, it's also great for dyslexics. It's a little more flexible than an audiobook, but for my purposes, it's basically an audiobook with a visible HTML side.

edited tags
Link
Cyn
  • 32.4k
  • 6
  • 77
  • 145
added explanations on IDE (from my limited understanding) and DAISY. New title.
Source Link
Loading
Tweeted twitter.com/StackWriting/status/1126683436402524160
Explained the term IDE according to the comment discussion
Source Link
Secespitus
  • 5.7k
  • 4
  • 47
  • 96
Loading
Source Link
Loading