Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • World
  • Users
  • Groups
Skins
  • Light
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Default (No Skin)
  • No Skin
Collapse
Code Project
  1. Home
  2. The Lounge
  3. Hello World...

Hello World...

Scheduled Pinned Locked Moved The Lounge
htmlcomhelpquestion
34 Posts 14 Posters 53 Views 1 Watching
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • R Rama Krishna Vavilala

    JoeSox wrote: I have decided to use a .pdf file for my app's help file. Thank God! I am not using your app. What is the problem in sticking with the standard - HTML help.

    J Offline
    J Offline
    JoeSox
    wrote on last edited by
    #8

    Rama Krishna wrote: What is the problem in sticking with the standard - HTML help. I want it to be searchable. I want an index. This would mean I need to compile a .chm file what a bureaucratic process. Create the .htm files create the index, add the files blah, blah, blah!:mad: Adobe way... Create MS word document with Headers for your wanted bookmarks/index. when finished turn into .pdf walla!!:-D Later,
    JoeSox
    www.joeswammi.com
    USN Veteran 94-98[^]

    A 1 Reply Last reply
    0
    • J JoeSox

      :-D I have decided to use a .pdf file for my app's help file. Does anyone else like or dislike doing this? I think it is very fast and effective. the only con I can think of is that the user must download and install Acrobat reader but who doesn't have that??;P <newly added> additional reading[^] </newly added> Later,
      JoeSox
      www.joeswammi.com
      USN Veteran 94-98[^]

      A Offline
      A Offline
      Anders Molin
      wrote on last edited by
      #9

      I hate pdf-files for help or documentation. It just plain sucks compared to html-help. - Anders Money talks, but all mine ever says is "Goodbye!"

      J 1 Reply Last reply
      0
      • A Anders Molin

        I hate pdf-files for help or documentation. It just plain sucks compared to html-help. - Anders Money talks, but all mine ever says is "Goodbye!"

        J Offline
        J Offline
        JoeSox
        wrote on last edited by
        #10

        Anders Molin wrote: It just plain sucks compared to html-help. perhaps but compiling it sucks even more don't you think? Later,
        JoeSox
        www.joeswammi.com
        USN Veteran 94-98[^]

        N A D 3 Replies Last reply
        0
        • J JoeSox

          :-D I have decided to use a .pdf file for my app's help file. Does anyone else like or dislike doing this? I think it is very fast and effective. the only con I can think of is that the user must download and install Acrobat reader but who doesn't have that??;P <newly added> additional reading[^] </newly added> Later,
          JoeSox
          www.joeswammi.com
          USN Veteran 94-98[^]

          D Offline
          D Offline
          David Wulff
          wrote on last edited by
          #11

          NOOOOOOOOOOOOOOOOOOOO!! [ edited version: whoops, I forgot that would scroll! :eek: ]


          David Wulff

          "Somebody get this freakin' duck away from me!" - Strong Bad [^]

          N 1 Reply Last reply
          0
          • D David Wulff

            NOOOOOOOOOOOOOOOOOOOO!! [ edited version: whoops, I forgot that would scroll! :eek: ]


            David Wulff

            "Somebody get this freakin' duck away from me!" - Strong Bad [^]

            N Offline
            N Offline
            Nish Nishant
            wrote on last edited by
            #12

            The least you could have done was to split the NOO...OOO into multiple lines to prevent horiz scrolling! And you are the guy who's the author of the best working version of these forums. Tut tut Dave tut tut. Nish p.s. Tut again...


            Author of the romantic comedy Summer Love and Some more Cricket [New Win] Review by Shog9 Click here for review[NW]

            D 1 Reply Last reply
            0
            • J JoeSox

              :-D I have decided to use a .pdf file for my app's help file. Does anyone else like or dislike doing this? I think it is very fast and effective. the only con I can think of is that the user must download and install Acrobat reader but who doesn't have that??;P <newly added> additional reading[^] </newly added> Later,
              JoeSox
              www.joeswammi.com
              USN Veteran 94-98[^]

              N Offline
              N Offline
              Nish Nishant
              wrote on last edited by
              #13

              PDF files suck as help files Joe. Totally suck. If you dont want a chm file just put a group of crosslinked html files in the [app path]/helpfiles folder and spawn it on IE. That's far better than slow clumsy PDF files. Nish


              Author of the romantic comedy Summer Love and Some more Cricket [New Win] Review by Shog9 Click here for review[NW]

              J 1 Reply Last reply
              0
              • N Nish Nishant

                The least you could have done was to split the NOO...OOO into multiple lines to prevent horiz scrolling! And you are the guy who's the author of the best working version of these forums. Tut tut Dave tut tut. Nish p.s. Tut again...


                Author of the romantic comedy Summer Love and Some more Cricket [New Win] Review by Shog9 Click here for review[NW]

                D Offline
                D Offline
                David Wulff
                wrote on last edited by
                #14

                I noticed as soon as it loaded after posting it. :-O Having to scroll nine pages to see the "modify" link was possibly a bit much, so I edited it to a moderately smaller versoin. :)


                David Wulff

                "Somebody get this freakin' duck away from me!" - Strong Bad [^]

                N 1 Reply Last reply
                0
                • D David Wulff

                  I noticed as soon as it loaded after posting it. :-O Having to scroll nine pages to see the "modify" link was possibly a bit much, so I edited it to a moderately smaller versoin. :)


                  David Wulff

                  "Somebody get this freakin' duck away from me!" - Strong Bad [^]

                  N Offline
                  N Offline
                  Nish Nishant
                  wrote on last edited by
                  #15

                  David Wulff wrote: so I edited it to a moderately smaller versoin. Cool :-) Nish


                  Author of the romantic comedy Summer Love and Some more Cricket [New Win] Review by Shog9 Click here for review[NW]

                  1 Reply Last reply
                  0
                  • J JoeSox

                    :-D I have decided to use a .pdf file for my app's help file. Does anyone else like or dislike doing this? I think it is very fast and effective. the only con I can think of is that the user must download and install Acrobat reader but who doesn't have that??;P <newly added> additional reading[^] </newly added> Later,
                    JoeSox
                    www.joeswammi.com
                    USN Veteran 94-98[^]

                    O Offline
                    O Offline
                    OCid
                    wrote on last edited by
                    #16

                    Well, it seems that I’m the only one who is going to support your initiative on using pdf as help files. They are great to produce printable versions of the help. In my experience, a lot of customers prefer to print out the help documents (at least the basics) than working with the online version. Standard WinHelp/htmlHelp based systems really suck on this point. To be honest, now I’m offering two versions to my users: htmlhelp+pdf documents. What I’m doing is using DocToHelp which allows you to create your help documents using Word

                    L J 2 Replies Last reply
                    0
                    • J JoeSox

                      Anders Molin wrote: It just plain sucks compared to html-help. perhaps but compiling it sucks even more don't you think? Later,
                      JoeSox
                      www.joeswammi.com
                      USN Veteran 94-98[^]

                      N Offline
                      N Offline
                      Neville Franks
                      wrote on last edited by
                      #17

                      JoeSox wrote: Anders Molin wrote: It just plain sucks compared to html-help. perhaps but compiling it sucks even more don't you think? Nope. One gets the impression you have no interest in the end-user experience, only what is easier for you the developer. I hope this attitude doesn't carry through to the entire application. Like everyone else has said PDF sucks for on line help. Neville Franks, Author of ED for Windows. www.getsoft.com Make money with our new Affilate program

                      1 Reply Last reply
                      0
                      • J JoeSox

                        mgama wrote: Scrolling is jerky and slow. I don't understand why. I haven't experienced this. Are these symptoms caused by older machines? System requirement and such? Later,
                        JoeSox
                        www.joeswammi.com
                        USN Veteran 94-98[^]

                        G Offline
                        G Offline
                        Gary Kirkham
                        wrote on last edited by
                        #18

                        I agree with mgama and Roger. They are slow to load and don't have good mouse wheel support. I don't think it is specific to old software or machines. I have a fairly new 2.4 Ghz P4 running Win2K. When I get ready to develop my next help system (next month), I will probably use html. The main reason is that the software is implemented on Windows and the MacOS. I want one help system to work on both, which would also lend itself to the pdf format. Gary Kirkham A working Program is one that has only unobserved bugs I thought I wanted a career, turns out I just wanted paychecks

                        1 Reply Last reply
                        0
                        • J JoeSox

                          Roger Wright wrote: I hate .pdf files. They are a PITA wherever I find them, and most help files are bad enough without the added aggravation. They're slow to load, behave erratically with wheelmouse drivers, and print badly on many printers. I took steps to solve these problems in my .pdf. I am using a think font. when the pdf is opened the bookmarks/contents is opened on the left. I have not experienced the wheelmouse problems, what version of Acrobat are you using?;) better yet, time to get a new mouse?:-D Later,
                          JoeSox
                          www.joeswammi.com
                          USN Veteran 94-98[^]

                          R Offline
                          R Offline
                          Roger Wright
                          wrote on last edited by
                          #19

                          All versions of Acrobat suffer the problem, and it doesn't matter what age or make of mouse. The contents pane is nice; what I like best is that I can close it.:-D Ancient man conquered his rivals with the jawbone of an ass; modern man uses the jawbone of a politician.

                          1 Reply Last reply
                          0
                          • J JoeSox

                            Anders Molin wrote: It just plain sucks compared to html-help. perhaps but compiling it sucks even more don't you think? Later,
                            JoeSox
                            www.joeswammi.com
                            USN Veteran 94-98[^]

                            A Offline
                            A Offline
                            Anders Molin
                            wrote on last edited by
                            #20

                            JoeSox wrote: but compiling it sucks even more don't you think Maybe, and so what. Are you interested in making online help that's good to use for the users, or easy to make for you? Usability, ever heard about that? - Anders Money talks, but all mine ever says is "Goodbye!"

                            1 Reply Last reply
                            0
                            • J JoeSox

                              mgama wrote: Scrolling is jerky and slow. I don't understand why. I haven't experienced this. Are these symptoms caused by older machines? System requirement and such? Later,
                              JoeSox
                              www.joeswammi.com
                              USN Veteran 94-98[^]

                              D Offline
                              D Offline
                              Daniel Turini
                              wrote on last edited by
                              #21

                              JoeSox wrote: I don't understand why. I haven't experienced this. Are these symptoms caused by older machines? System requirement and such? A slow software is a slow software no matter what machine you have. Browsing the web is way faster than using pdf. I hate them. Specs: 2xPIII 800, 512Mb RAM, RIVA TNT2 32Mb. No the fastest machine in the world, but I used to read documents faster than on Acrobat Reader with my XT 4.77Mhz on DOS 3.1.


                              It's not the fall that kills you: it's the sudden stop - Down by Law, Jim Jamursch (1986)

                              1 Reply Last reply
                              0
                              • J JoeSox

                                Anders Molin wrote: It just plain sucks compared to html-help. perhaps but compiling it sucks even more don't you think? Later,
                                JoeSox
                                www.joeswammi.com
                                USN Veteran 94-98[^]

                                D Offline
                                D Offline
                                Daniel Turini
                                wrote on last edited by
                                #22

                                JoeSox wrote: perhaps but compiling it sucks even more don't you think? If complexity is a problem for you, give them a plain textfile named README or INSTALL, like they do on Linux. Without an extension, all caps, because it's easier to do this way.


                                It's not the fall that kills you: it's the sudden stop - Down by Law, Jim Jamursch (1986)

                                J 1 Reply Last reply
                                0
                                • J JoeSox

                                  Rama Krishna wrote: What is the problem in sticking with the standard - HTML help. I want it to be searchable. I want an index. This would mean I need to compile a .chm file what a bureaucratic process. Create the .htm files create the index, add the files blah, blah, blah!:mad: Adobe way... Create MS word document with Headers for your wanted bookmarks/index. when finished turn into .pdf walla!!:-D Later,
                                  JoeSox
                                  www.joeswammi.com
                                  USN Veteran 94-98[^]

                                  A Offline
                                  A Offline
                                  Anders Molin
                                  wrote on last edited by
                                  #23

                                  JoeSox wrote: Adobe way... Yea, and then the user try to press F1.... X| - Anders Money talks, but all mine ever says is "Goodbye!"

                                  1 Reply Last reply
                                  0
                                  • O OCid

                                    Well, it seems that I’m the only one who is going to support your initiative on using pdf as help files. They are great to produce printable versions of the help. In my experience, a lot of customers prefer to print out the help documents (at least the basics) than working with the online version. Standard WinHelp/htmlHelp based systems really suck on this point. To be honest, now I’m offering two versions to my users: htmlhelp+pdf documents. What I’m doing is using DocToHelp which allows you to create your help documents using Word

                                    L Offline
                                    L Offline
                                    Lost User
                                    wrote on last edited by
                                    #24

                                    Doc2Help is too expensive for me though. My article on a reference-counted smart pointer that supports polymorphic objects and raw pointers

                                    1 Reply Last reply
                                    0
                                    • J JoeSox

                                      :-D I have decided to use a .pdf file for my app's help file. Does anyone else like or dislike doing this? I think it is very fast and effective. the only con I can think of is that the user must download and install Acrobat reader but who doesn't have that??;P <newly added> additional reading[^] </newly added> Later,
                                      JoeSox
                                      www.joeswammi.com
                                      USN Veteran 94-98[^]

                                      L Offline
                                      L Offline
                                      Lost User
                                      wrote on last edited by
                                      #25

                                      Unless you are creating a print manual, that is not a good idea. How could you ever create a context sensitive help with that kind of a framework? My article on a reference-counted smart pointer that supports polymorphic objects and raw pointers

                                      J 1 Reply Last reply
                                      0
                                      • D Daniel Turini

                                        JoeSox wrote: perhaps but compiling it sucks even more don't you think? If complexity is a problem for you, give them a plain textfile named README or INSTALL, like they do on Linux. Without an extension, all caps, because it's easier to do this way.


                                        It's not the fall that kills you: it's the sudden stop - Down by Law, Jim Jamursch (1986)

                                        J Offline
                                        J Offline
                                        JoeSox
                                        wrote on last edited by
                                        #26

                                        Daniel Turini wrote: If complexity is a problem for you it kind of is, and time too. It's just me, I have a hard time trying to find the time to program the main app. I don't have time to remember the three or four damn apps I need to use just to create the help .chm. Daniel Turini wrote: give them a plain textfile named README or INSTALL, That's a good solution, thanks. I think I will turn the Word document into html and use that, and have an option to use the pdf? ahh file size? well damn I don't know. I explain in an earlier post why I am so rushed. This year's version will DIFFENATLY be freeware. Later,
                                        JoeSox
                                        www.joeswammi.com
                                        USN Veteran 94-98[^]

                                        1 Reply Last reply
                                        0
                                        • N Nish Nishant

                                          PDF files suck as help files Joe. Totally suck. If you dont want a chm file just put a group of crosslinked html files in the [app path]/helpfiles folder and spawn it on IE. That's far better than slow clumsy PDF files. Nish


                                          Author of the romantic comedy Summer Love and Some more Cricket [New Win] Review by Shog9 Click here for review[NW]

                                          J Offline
                                          J Offline
                                          JoeSox
                                          wrote on last edited by
                                          #27

                                          Nishant S wrote: That's far better than slow clumsy PDF files. I don't understand why people keep saying this:confused: I am not loading the pdf in IE, just in Acrobat Reader, waiting for the splash screen to load, is that it? Beleive me, if I had the time I would do html. but I don't:(( Later,
                                          JoeSox
                                          www.joeswammi.com
                                          USN Veteran 94-98[^]

                                          1 Reply Last reply
                                          0
                                          Reply
                                          • Reply as topic
                                          Log in to reply
                                          • Oldest to Newest
                                          • Newest to Oldest
                                          • Most Votes


                                          • Login

                                          • Don't have an account? Register

                                          • Login or register to search.
                                          • First post
                                            Last post
                                          0
                                          • Categories
                                          • Recent
                                          • Tags
                                          • Popular
                                          • World
                                          • Users
                                          • Groups