Apple Help and remote help content?

  • I've gotten the basic help system working locally (i.e. I can open my
    applications help, browse the various pages I've created, etc... all
    the expected functionality is there) but can't seem to figure out what
    I've done wrong when I attempt to go with a network-based help
    system.  I believe I've followed the correct sequence of steps:

    1) Open Help Indexer->Preferences
    2) Enable 'Use remote root for missing files and updates'
    3) Enable 'Prefer network files to local files'
    4) Enter the URL to the top level help directory on the server
    5) Reindex my content
    6) Rebuild the app
    7) FTP the 'updated' content up to the server (right now it's just the
    same files with some text indicating 'this is from the server' in my
    top-level help page)

    The problem I'm having is that the help system isn't checking with the
    server (it did the first time I tried it but I had some settings
    problems which have since been corrected) so the local content is
    always being used... are there any debugging/logging techniques to
    finding out what the help system thinks is going on and/or wrong?  One
    thing I'm thinking since it attempted to check the first time: are
    there any default caching/timeout settings that would cause this
    behavior that I could change and/or disable while testing this out?
    (I haven't set anything in my pages so they are fairly vanilla HTML
    right now)

    Thanks,
    Phil
  • On Mon, 7 Jan 2008 18:00:00 -0500, Phil <pbpublist...> said:
    > I've gotten the basic help system working locally (i.e. I can open my
    > applications help, browse the various pages I've created, etc... all
    > the expected functionality is there) but can't seem to figure out what
    > I've done wrong when I attempt to go with a network-based help
    > system.  I believe I've followed the correct sequence of steps:
    >
    > 1) Open Help Indexer-> Preferences
    > 2) Enable 'Use remote root for missing files and updates'
    > 3) Enable 'Prefer network files to local files'
    > 4) Enter the URL to the top level help directory on the server
    > 5) Reindex my content
    > 6) Rebuild the app
    > 7) FTP the 'updated' content up to the server (right now it's just the
    > same files with some text indicating 'this is from the server' in my
    > top-level help page)
    >
    > The problem I'm having is that the help system isn't checking with the
    > server (it did the first time I tried it but I had some settings
    > problems which have since been corrected) so the local content is
    > always being used... are there any debugging/logging techniques to
    > finding out what the help system thinks is going on and/or wrong?  One
    > thing I'm thinking since it attempted to check the first time: are
    > there any default caching/timeout settings that would cause this
    > behavior that I could change and/or disable while testing this out?
    > (I haven't set anything in my pages so they are fairly vanilla HTML
    > right now)

    Good thread over in the better list on this topic:

    http://lists.apple.com/archives/apple-help-authoring/2004/May/msg00018.html

    m.

    --
    matt neuburg, phd = <matt...>, <http://www.tidbits.com/matt/>
    A fool + a tool + an autorelease pool = cool!
    One of the 2007 MacTech Top 25: <http://tinyurl.com/2rh4pf>
    AppleScript: the Definitive Guide - Second Edition!
    <http://www.amazon.com/gp/product/0596102119>
  • Matt,

    Thanks for the pointers both to the apple-help list as well as the
    thread.  If I can't find the answers I need have been already
    answered, I'll repost my question on that list.

    Phil

    On Jan 12, 2008, at 11:04 PM, Matt Neuburg wrote:

    > On Mon, 7 Jan 2008 18:00:00 -0500, Phil <pbpublist...> said:
    >> I've gotten the basic help system working locally (i.e. I can open my
    >> applications help, browse the various pages I've created, etc... all
    >> the expected functionality is there) but can't seem to figure out
    >> what
    >> I've done wrong when I attempt to go with a network-based help
    >> system.  I believe I've followed the correct sequence of steps:
    >>
    >> 1) Open Help Indexer->Preferences
    >> 2) Enable 'Use remote root for missing files and updates'
    >> 3) Enable 'Prefer network files to local files'
    >> 4) Enter the URL to the top level help directory on the server
    >> 5) Reindex my content
    >> 6) Rebuild the app
    >> 7) FTP the 'updated' content up to the server (right now it's just
    >> the
    >> same files with some text indicating 'this is from the server' in my
    >> top-level help page)
    >>
    >> The problem I'm having is that the help system isn't checking with
    >> the
    >> server (it did the first time I tried it but I had some settings
    >> problems which have since been corrected) so the local content is
    >> always being used... are there any debugging/logging techniques to
    >> finding out what the help system thinks is going on and/or wrong?
    >> One
    >> thing I'm thinking since it attempted to check the first time: are
    >> there any default caching/timeout settings that would cause this
    >> behavior that I could change and/or disable while testing this out?
    >> (I haven't set anything in my pages so they are fairly vanilla HTML
    >> right now)
    >
    > Good thread over in the better list on this topic:
    >
    > http://lists.apple.com/archives/apple-help-authoring/2004/May/msg00018.html
    >
    > m.
    >
    > --
    > matt neuburg, phd = <matt...>, <http://www.tidbits.com/matt/>
    > A fool + a tool + an autorelease pool = cool!
    > One of the 2007 MacTech Top 25: <http://tinyurl.com/2rh4pf>
    > AppleScript: the Definitive Guide - Second Edition!
    > <http://www.amazon.com/gp/product/0596102119>
    >
    >
    >
previous month january 2008 next month
MTWTFSS
  1 2 3 4 5 6
7 8 9 10 11 12 13
14 15 16 17 18 19 20
21 22 23 24 25 26 27
28 29 30 31      
Go to today