How should a TOC look?

Folks, a newbie question:
Ok, so, I’ve not had any training, and no books, just
the robohelp-html o/l help system. And I have some issues.
Problem: trying to load 300 pages of old documentation into
robohelp-html (webhelp format), to get it around, and get feedback
from folks on what/how to improve the documentation.
Media: the doc was done by various authors, at different
times, with different objectives. So, I have done the following:
- created word styles for heading 1,2,3, for body text and
for (un-numbered) lists
- converted the doc to these styles
- separated the doc into 12 chapters, each in it’s own
folder, extracting embedded pictures, and creating a toc for each
chapter (no page numbering, ‘classic’ style)
now, when I load a chapter just to test, I get a strange
result (or maybe, this is what it is supposed to look like?):
- chapter x has a layout sort of like this:
o H1
§ H2 with some text
§ H2
· H3 with some text
· H3 with some text
§ H2 with some text
o H1
§ H2
· H3 with some text
· H3 with some text
- when I bring it in to robohelp-html, using the word import
function (and I say create topic with H1), and running
‘generate primary layout’, I see:
o 2 ‘books’ in the toc, one book each for each of
the H1
o when I expand the 2 books, I get under the first box (the
first H1)
§ a ‘question mark’ box with the first H2
title
§ a book for the next H2 with ‘question
mark’ boxes for each of the H3 titles
o etc for the 2nd H1 book
- IS THIS THE FORMATTING I’M SUPPOSED TO BE GETTING?
Seems kind of odd, yet it clearly has structure.
I’ve tried various combinations when I do the import
function, but they don’t seem to alter much. And I could be
at this combo testing for quite some time – so I thought
I’d ask for some input.
Thanks, Ron

Thomas Phinney wrote:
Well, that is a serious, conservative layout, sure. I'm assuming the red text is instructions/suggestions from the teacher, and gets replaced by black text. Is that right?
Is the purpose of the business plan to attract investors or convince a bank or something? If it was, I'd probably change the typeface selection so that it wasn't all in Times. Nothing radical, but maybe a slightly more flavorful sans serif for headings, and a serif body typeface with a tiny bit more character. Could be for example Frutiger and Baskerville. Still pretty restrained, just not identical to most of the business plans they see.
But then again, I'm the guy who jailbroke his iPhone primarily to change the UI typeface, and asked the forum admins to change the default typeface here as well. So maybe I'm a little obsessive on this sort of thing.
Cheers,
T
Oh yes indeed, it's for investors who go through hundreds of Times-based business plans every day. I really like the way you worded things there, "still restrained, just not identical to most of the business plans they see".
Frutiger and Baskerville is a great suggestion! I'm open to more before I go ahead and buy myself a new pair of fonts though.
Much obliged!

Similar Messages

  • How should my VIs look?

    I'm relatively new to LabVIEW and as I'm building bigger and bigger VIs with multiple subVIs, etc.  I've been wondering what makes a good "looking" program.  Basically... how should I organize it so that it's readable and makes sense to another person.
    Is there any where I can find some good examples of this with some more complicated programs?  I did a quick search and didn't find anything, but please let me know if you know of anything.  Thanks.

    At first, this looks good, your wiring is clean and easy to follow the data flow. I've some worse code in my own projects.
    So let's see where/how you can reduce the overall BD size.
    The timed loop has some empty space between code and checking the exit condition.
    The VISA code is a good candidate for SubVIs, especially the VSET command could be a single reusable SubVI that takes a dbl. Same for the ISET
    You also can make SubVIs without intending them for reuse. I think about a XNET/CAN Init.vi. Would save a lot of real estate.
    Test Info Names could be a Constant.vi (so just the constant feeding an indicator). Might be reusable if you read from the TDMS at another place. I also use small VI Icons for such VI's, about half the size of a normal 32x32 icon. You need to make the 256 and the BW color Icon of a reduced size, then the outer part is made transparent.
    Use clusters, e.g. max volts, min volts, volt inc, set amps could go into one cluster. You can make the borders transparent, so it doesn't look like a cluster on the FP. Helps you to make that code a SubVi as you only need a single control (the cluster). Make the cluster a type def so you only need to change the type def and not SubVI and FP.
    Same place, consider using a dialog for setting up the measurement. Then all can go into a single vi (including the FP code/indicator).
    I think that using SubVIs will also get down a second optical 'bug', that you have a very highly nested structure (look at the bottom right corner and see that you have 4 error catching case structures). I normally place the error catching case around my event structure. Maybe this already gets you rid of one. Also I think some of them are unnecessary, as code isn't executed with an error on the wire (e.g. the TDMS and VISA vi's won't do anything when called with an error).
    As an alternative, use a state machine that basically just goes Init CAN -> Init Visa device -> Run -> Shutdown with branches to an error handling state or to the shutdown state (e.g. if cancelled by the user).
    Other points to change:
    The run button is outside the coresponding event frame. Place it inside the event frame to get the latching working.
    Error handling. The outer while loop has no shift registers on the error wire and no abort if an error occures, so you will drop errors without noticing.
    Felix
    www.aescusoft.de
    My latest community nugget on producer/consumer design
    My current blog: A journey through uml

  • How should my keystore look like?

    Hi
    I need my clients to communicate with each other plus servlets via XMLRPC and SSL. I'm using selfsigned certificates (CA servlet) which are created and signed inline (no keytool) and stored in keystores (again inline).
    My CA servlet keystore includes:
    alias server: selfsigned certificate, keyentry (tried out chain by adding CA servlet certificate)
    Client keystore:
    alias client: client certificate (signed by CA servlet), CA certificate (chain), keyentry
    alias server: CA servlet certificate (trusted certificate)
    Is the 'format' of the keystores valid for SSL? I'm always getting either: Unknown host exception or IOException: HTTPS hostname wrong: should be <localhost>.
    I've got a dummy TrustManager and HostNameVerifier, which should trust all certificates, but it's not working. I also tried to add my selfsigned certificate to Sun's trusted certificates, but still no success.
    I'm stuck, any help appreciated!
    Thanks!

    Hi
    I need my clients to communicate with each other plus servlets via XMLRPC and SSL. I'm using selfsigned certificates (CA servlet) which are created and signed inline (no keytool) and stored in keystores (again inline).
    My CA servlet keystore includes:
    alias server: selfsigned certificate, keyentry (tried out chain by adding CA servlet certificate)
    Client keystore:
    alias client: client certificate (signed by CA servlet), CA certificate (chain), keyentry
    alias server: CA servlet certificate (trusted certificate)
    Is the 'format' of the keystores valid for SSL? I'm always getting either: Unknown host exception or IOException: HTTPS hostname wrong: should be <localhost>.
    I've got a dummy TrustManager and HostNameVerifier, which should trust all certificates, but it's not working. I also tried to add my selfsigned certificate to Sun's trusted certificates, but still no success.
    I'm stuck, any help appreciated!
    Thanks!

  • How should a professional business plan look like?

    Hi,
    How should a professional business plan look like?
    My teacher just gave me this sample business plan. Now, the content is alright, but what about the typography? I'm not sure, I'm not really a designer, but I do get the feeling it's not as beautiful as it could be. I take it a business plan should appear serious and controlled, almost conservative, as to show investors that you won't do anything stupid with their money. Also, I remember reading somewhere that the best typography is the kind of typography that goes by unnoticed (e.g. nothing fancy) as to not divert the reader's attention from the actual content.
    I don't know, what do you guys say?
    Thanks!

    Thomas Phinney wrote:
    Well, that is a serious, conservative layout, sure. I'm assuming the red text is instructions/suggestions from the teacher, and gets replaced by black text. Is that right?
    Is the purpose of the business plan to attract investors or convince a bank or something? If it was, I'd probably change the typeface selection so that it wasn't all in Times. Nothing radical, but maybe a slightly more flavorful sans serif for headings, and a serif body typeface with a tiny bit more character. Could be for example Frutiger and Baskerville. Still pretty restrained, just not identical to most of the business plans they see.
    But then again, I'm the guy who jailbroke his iPhone primarily to change the UI typeface, and asked the forum admins to change the default typeface here as well. So maybe I'm a little obsessive on this sort of thing.
    Cheers,
    T
    Oh yes indeed, it's for investors who go through hundreds of Times-based business plans every day. I really like the way you worded things there, "still restrained, just not identical to most of the business plans they see".
    Frutiger and Baskerville is a great suggestion! I'm open to more before I go ahead and buy myself a new pair of fonts though.
    Much obliged!

  • How Should My Heat Sink Gel Look?

    Hey all,
    Is this enough heat sink gel for my fan fixture to board connection? 
    I was having problems with overheating while gaming, so I took my fan fixture out and cleaned it out real well. Doing this required me to pull it away from the board, and I'm not sure if I should have cleaned the heat sink gel off and re-applied some new.
    Here are some photos of how the physical connection looks. I simply put it back and place, and here I am typing to you now:
    http://rosshardy.com/files/images/IMG_2241.JPG
    http://rosshardy.com/files/images/IMG_2240.JPG
    Thanks!
    Ross
    P.S., my warrenty already expired (I'm aware that I would have voided it). 

    lead_org's idea of useing a credit-card or similar tool to spread the compound is a good idea.
    My idea of iceing on a cake was a bit vague I suppose. The point was an even thin layer, liberally applied to fill the neccesary imperfections, yet thin enough to not be wasteful.
    This excerpt from the Wikipedia artical on "Thermal Grease" may enlighten things a bit for all in question. There's more for those technically interested on the Wikipedia web site; referrenced via the link above, but I think the notes below should suffice enough info for the average person.
    Purpose
    Thermal grease is primarily used in the electronics and computer industries to assist a heatsink to draw heat away from a semiconductor component such as an integrated circuit or transistor.
    Thermally conductive paste improves the efficiency of a heatsink by filling air gaps that occur when the irregular surface of a heat generating component is pressed against the irregular surface of a heatsink, air being approximately 8000 times less efficient at conducting heat (see Thermal conductivity) than, for example, aluminium, a common heatsink material.[2] Surface imperfections inherently arise from limitations in manufacturing technology and range in size from visible and tactile flaws such as machining marks or casting irregularities to sub-microscopic ones not visible to the naked eye.
    As such, both the thermal conductivity and the "conformability" (i.e., the ability of the material to conform to irregular surfaces) are the important characteristics of thermal grease.
    Both high power handling transistors, like those in a conventional audio amplifier, and high speed integrated circuits, such as the central processing unit (CPU) of a personal computer, generate sufficient heat to require the use of thermal grease in addition to the heatsink. High temperatures cause semiconductors to change their switching properties to the point of failure while CPU power dissipation overheating causes logic errors as heat raises electrical resistance on the multi-nanometer wide circuits of the CPU core.[3] 
    Applying and removing
    Computer processor heatsinks utilize a variety of designs to promote better thermal transfer between components. Flat and smooth surfaces may use a small line method to apply material, and exposed heat-pipe surfaces will be best prepared with multiple lines.[4]
    Because thermal grease's thermal conductivity is poorer than the metals they couple, it is important to use no more than is necessary to exclude air gaps. Excess grease separating the metal surfaces further will only degrade conductivity, increasing the chances of overheating. It should also be noted that silver-based thermal grease can also be slightly electrically conductive. If excess were to flow onto the circuits, it could cause a short circuit.
    The preferred way to remove typical silicone oil-based thermal grease from a component or heat sink is by using isopropyl alcohol (rubbing alcohol). If none is available, pure acetone is also a valid method of removal. There are also purpose made cleaners for removing and purifying the surfaces of the contacts.
    HTH.....
    Regards,
    Visible_Spirit

  • 2 domain, each with 2 way transitive truts, with sub domains pointing to the same DNS server (how should forward and reserver look zone be configured)

    Hello,
    I found a test environment and I just trying to understand how it works.
    If I have two domains (a.com and b.com) with sub domains(a1.com and b1.com) with two way trust and I want them to point to a Windows DNS server. How should the Forward lookup zones and Reverse lookup zones be configured? In forward lookup
    zones do I just add a new zone, make them all primary since only one DNS server, add a.com and b.com and do the same for reverse zones.
    Do the sub domains need to be added? What about pointers? Do I add the IP address of a.com and b.com in reverse lookup zones.
    A side question: When you create a Domain with dns AD intergrated the forward and reserve lookup are automatically created. You don't need to add the zone of the domain you just created but have to add zones of other domains.

    Hello,
    I found a test environment and I just trying to understand how it works.
    If I have two domains (a.com and b.com) with sub domains(a1.com and b1.com) with two way trust and I want them to point to a Windows DNS server. How should the Forward lookup zones and Reverse lookup zones be configured? In forward lookup
    zones do I just add a new zone, make them all primary since only one DNS server, add a.com and b.com and do the same for reverse zones.
    Do the sub domains need to be added? What about pointers? Do I add the IP address of a.com and b.com in reverse lookup zones.
    A side question: When you create a Domain with dns AD intergrated the forward and reserve lookup are automatically created. You don't need to add the zone of the domain you just created but have to add zones of other domains.
    Make each domain controller as a DNS server too. Reverse lookup zones & forwarders are not replicated automatically. You can create AD-Integrated reverse lookup zone & set the replication scope.
    You can create AD-Integrated DNS zones in the parent/root domain, set the replication scope to the forest-wide & delegate the zones for handling request locally. Once you create AD-Integrated DNS zone & set the replication scope forest wide, all
    the zones will appear automatically in each domain's DNS server.
    http://awinish.wordpress.com/2011/04/09/configuring-dns-in-child-domain/
    Awinish Vishwakarma - MVP
    My Blog: awinish.wordpress.com
    Disclaimer This posting is provided AS-IS with no warranties/guarantees and confers no rights.

  • How should I reformat my external hard drive?

    I have just purchased a new 21.5" iMac and I will be moving from PC to iMac. I currently have a 2.5TB external hard drive which I have connected to my PC laptop that I use to store and watch movies. My question is how should I format/partition my external hard drive so that I can use it with my new iMac? The external hard drive will solely be used with my new iMac (it won't be connected/used with my laptop again) and I am ok with losing the data on the external hard drive as I have backed up the data currently on it onto another hard drive. I have tried to research what format to use but I am a little confused as to which one is the best and I am looking for some advice.

    Mac OS Extended (Journaled).
    (73546)

  • I accidentally dropped macbook air that was in a book bag. The keyboard is working because I can see the light but the screen is black and it won't turn off. How should I fix this? Please Help ME!!

    I accidentally dropped my friend's macbook air that was in a book bag. The keyboard is working because I can see the light but the screen is black and it won't turn off. How should I fix this? Please Help ME!!
    I tried to turn it off and it didn't work... and I held on to the shift key too and it still doesn't work..
    Please help me..

    Accidental damage is not covered under Apple warranty.  And it seems there is much accidental damage.  Only a Genius Bar tech looking at it can tell how much it will cost to repair.
    Cost to repair will be high, I suspect (though Genius Bar will confirm/deny.
    There is no gentle way to say this sir/ma'am ... someone will need to pay for your friend's MBA repairs.

  • I have a mac pro g4 when i load a cd or dvd there is no start up noise from drive and icon will not show on desktop or in itunes. How should i troubleshoot? pioneer 105 mirror door

    I have a mac pro g4 when i load a cd or dvd there is no start up noise from drive and icon will not show on desktop or in itunes. How should i troubleshoot? pioneer 105 mirror door

    PIONEER DVD-RW  DVR-105:
      Firmware Revision:          A506
      Interconnect:          ATAPI
      Burn Support:          Yes (Apple Shipping Drive)
      Cache:          2000 KB
      Reads DVD:          Yes
      CD-Write:          -R, -RW
      DVD-Write:          -R, -RW
      Write Strategies:          CD-TAO, CD-SAO, CD-Raw, DVD-DAO
      Media:          Insert media and refresh to show available burn speeds
    yes its a power mac thanks its been a long month and Merry Christmas thanks for checking my question im hoping its a driver problem but not liking some other stuff looking like replace drive

  • How should i use the two results sets in one single report data region?

    Hi frnz,
     I have to create a report using the below condition...
    Here my given data  set query gives you the two result sets ,so how should i use that two result sets information in single report....when i accessing that data set query it will take the values off the first result set not for the second result set.
    without using sub report and look up functionality..... if possible
    is there any way to achieve this.....Please let me know..
    Thanks!

    You cant get both resultsets in SSRS. SSRS dataset will only take the first resultset
    you need to either create them as separate queries or merge them into a single resultset and return with ad additional hardcoded field which indicates resultset (ie resultset1,resultset2 etc)
    Then inside SSRS report you can filter on the field to fetch individual resultsets at required places. While merging you need to make sure metadata of two resultsets are made consistent ie number of columns and correcponding column data types should be same.
    In absence of required number of columns just put some placeholders using NULL
    Please Mark This As Answer if it helps to solve the issue Visakh ---------------------------- http://visakhm.blogspot.com/ https://www.facebook.com/VmBlogs

  • How should I tag content created in a master page when addressing accessibility before exporting to Acrobat?  I can't add the content to the articles pannel because it's locked.  I would also like to know how I shold tag my cove content.  I dont' want rea

    How should I tag content created in a master page when addressing accessibility before exporting to Acrobat?  I can't add the content to the articles panel because it's locked.  I would also like to know how I should tag my cove content.  I don't want the reader to get lost in content other than the body of the report, but I also don't want to ignore some content completely by tagging it as artifacts.  What should I do y'all?
    Thanks,
    Josh

    Hi Rob,
    From the screen shots it looks like your script is not formatted properly (you may refer to 'Paladin Script' in 'Sample Project' to get an idea of how the script should be formatted.).
    Further please follow the steps mentioned below to use Story to PP workflow.
    Create a new Film script in Adobe Story
    Create  scene heading – INT. LOCATION – Day (these will show up in the outline view panel on left hand side)
    Hit enter, hit TAB
    Enter the name of the speaker, hit TAB or ENTER
    Copy over the transcribed text
    Build your script this way
    Number scenes from the production menu
    Export ASTX file for your script : File->Export->.astx
    Open Premiere Pro
    Create a new project, bring in media
    In the project pane, find the "Scene" column
    For the clip that contains the spoken text, assign the same scene number to the clip as you have in the story script (lets say both are scene 1)
    Click out of the scene box in the project panel in Ppro
    Right click on the scene that you just assigned a scene number to and select – attach Story script
    Select the .astx fle you exported in step 8
    Click ok
    You should now see the script data in the metadata panel for the clip in the metadata panel.
    You can now run speech to text based on "Embedded Script metadata" to time align spoken word to the script.
    Let us know if this is helpful.
    Thanks
    Rashi - Story Team

  • How should we get the out put file-name same as in put file-name in file to

    Hi frnds,
    having hundreds of files in the sender system with different names, how should we get the out put file-name  in the receiver system same as the in put file-name in file to file scenario ?
    Thanks in advance.
    truly,
    snrvakiti.

    Hi,
    In Receiver File Adapter you can set under 'Adapter-Specific Message Properties'
    check Use Adapter-Specific Message Properties
    check Fail on Missing Adapter Message Properties
    Check File Name
    Have a look at this link,  [File_to_File|http://allsapnetweavernotes.blogspot.com/2008/09/how-can-i-access-filename-from-fileftp.html]
    Regards,
    P.Rajesh

  • I have a problem in iphone4,i am from india and bought a new unlocked iphone4 from USA last month.the problem is when i call someone their is disturbance in the voice and i cant hear the opposite person voice.please inform me how should i overcome this?

    I have a problem in iphone4,i am from india and bought a new unlocked iphone4 from USA last month.the problem is when i call someone their is disturbance in the voice and i cant hear the opposite person voice.please inform me how should i overcome this?

    There may be a defect in the phone. As you bought it in the US the only place you can get it looked at is in the US.
    When you say you bought it new, unlocked did you buy it directly from an Apple store? If you did not it was hacked to unlock it, which could also be your problem. Apple stores are the only place in the US that sells legitimately unlocked iPhones.

  • I can't find the specific music/song I want in iTunes, how should I get them?

    There is always a time that you would want to listen to specific songs,
    the problem from iTune is, some songs can't be found.
    For example, Christians song? Japanese songs and etc etc.
    I would like to know what and how should I do in order iTunes will have those songs available?
    Is there any form, or request that I can post to Apple?
    Or things is just the way it is, I can't do anything about it?
    Thanks and sorry for 'lame post'.

    Please note that while you can request music be carried in the iTunes Store, the owners of the tracks have to be willing to license them to the iTunes Store. Not all artists/record companies are willing, and not all artists have representation at all in some countries. So don't be surprised if nothing happens in response to your request. You may have to look to other download stores, many of which offer music in a format iTunes can accept, or import the music from CDs.
    Regards.

  • How to make website look correct in Safari, Firefox, and Chrome?

    Hello there. I'm working on a website which was inherited to me by someone who died. So I am left with all of his coding which is about 4 years old. Now I'm working on positioning of the website and i've found that the only browser the website looks like it's supposed to is Safari and I can't for the life of me figure out how to make it look right in all the browsers and on a phone or tablet. It might be easier if I started from scratch but unfortunately I don't get that luxury. Please help me.
    Here's a link...MuseumOfNaturalistory.com

    I dont understand what some of these errors are asking of me. For instance, this one...
    if (xmlhttp.readyState==4 && xmlhttp.status==200)

    This message may appear in several cases:
    You tried to include the "<" character in your page: you should escape it as "&lt;"
    You used an unescaped ampersand "&": this may be valid in some contexts, but it is recommended to use "&amp;", which is always safe.
    Another possibility is that you forgot to close quotes in a previous tag.
    That's the way the code has to be in order to function. What does it want from me?
    And then here....
    Line 71, Column 5: an attribute value must be a literal unless it contains only name characters   </div>✉You have used a character that is not considered a "name character" in an attribute value. Which characters are considered "name characters" varies between the different document types, but a good rule of thumb is that unless the value contains only lower or upper case letters in the range a-z you must put quotation marks around the value. In fact, unless you have extreme file size requirements it is a very very good idea to always put quote marks around your attribute values. It is never wrong to do so, and very often it is absolutely necessary.
    Line 71, Column 5: character "<" is not allowed in the value of attribute "id"   </div>✉It is possible that you violated the naming convention for this attribute. For example, id and name attributes must begin with a letter, not a digit.
    I have absolutely no clue what it is asking of me. Doesn't it have to be that way? Also why when I go to "Line 71" that isn't where this actual code is? Is there some special way to decipher this?

Maybe you are looking for