
Επιστροφή στις παλιές μέρες, Βοήθεια δεν ήταν ασήμαντο, αλλά είναι δυνατόν: να δημιουργήσει κάποια funky αρχείο .rtf με ειδικές ετικέτες, να τρέξει μέσα από ένα compiler, και έχεις ένα αρχείο WinHelp (.hlp) που λειτουργεί πραγματικά πολύ καλά.


Στη συνέχεια, η Microsoft αποφάσισε ότι WinHelp δεν ήταν ισχίο και δροσερό πια και να μεταφέρονται σε CHM, μέχρι το σημείο που πραγματικά περικόπηκε WinHelp από Vista.


Τώρα, CHM ίσως ωραία, αλλά ο καθένας που προσπάθησαν να ανοίξετε ένα αρχείο .chm στο Δίκτυο θα γνωρίζετε το ωραίο «Πλοήγηση στην ιστοσελίδα ακυρώθηκε» οθόνη που προκαλείται από τους περιορισμούς ασφαλείας.


Αν και υπάρχουν τρόποι για να CHM λειτουργεί από το δίκτυο, αυτό δεν είναι καθόλου μια καλή επιλογή, διότι όταν ο χρήστης πατήσει το κουμπί Βοήθεια θέλει να βοηθήσει και να μην χρειαστεί να κάνει κάποιες funky ρυθμίσεις.


Bottom Line: Θεωρώ CHM εντελώς άχρηστα. Αλλά με το να μην WinHelp είναι μια επιλογή πια ούτε, αναρωτιέμαι ποιες είναι οι εναλλακτικές λύσεις, ειδικά όταν πρόκειται για την ενσωμάτωση με την αίτησή μου (δηλαδή για WinHelp και CHM υπάρχουν λειτουργίες που σας επιτρέπουν να μεταβείτε απευθείας σε ένα θέμα);


PDF έχει το μειονέκτημα ότι απαιτεί το Adobe Reader (ή σε μία από τις πιο ελαφρύ αυτά που χρησιμοποιούν πολλοί άνθρωποι). Θα μπορούσα να ζήσω με αυτό το βλέπουμε και αυτό είναι το είδος του προτύπου στις μέρες μας, αλλά μπορεί να το πει με αξιοπιστία για να μεταβείτε σε μια συγκεκριμένη σελίδα / άγκυρα;


αρχεία HTML φαίνεται να είναι η καλύτερη επιλογή, τότε απλά πρέπει να ασχοληθεί με διαφορετικούς browsers (CSS και τέτοια).


*Επεξεργασία:* Ψάχνω να δημιουργήσετε τα δικά μου αρχεία βοήθειας. Όπως είμαι οπαδός του «No εγκατάστασης, μόλις Απόσπασμα και Run» Φιλοσοφία, είχα αυτό το πρόβλημα πολλές φορές στο παρελθόν, επειδή πολλοί από τους χρήστες μου θα το τρέξει από το δίκτυο, το οποίο προκαλεί ακριβώς αυτό το πρόβλημα.


Έτσι Ψάχνω για μια πιο ισχυρή και διαχρονική τρόπος για την παροχή βοήθειας προς τους χρήστες μου χωρίς να χρειάζεται να κωδικοποιήσει ένα διαφορετικό σύστημα βοήθειας για κάθε εφαρμογή κάνω.


CHM είναι ένα πολύ ωραίο σχήμα, αλλά Ασφαλείας Stuff καθιστά ακατάλληλο προς χρήση, όπως ένα σύστημα βοήθειας υποτίθεται ότι παρέχει βοήθεια στον χρήστη, για να μην δημιουργήσει ακόμη περισσότερα προβλήματα.

 
αρχεία των Windows Βοήθεια - ποιες είναι οι επιλογές;
=====================================================



HTML θα είναι η επόμενη καλύτερη επιλογή, μόνο αν θα τους εξυπηρετήσει από ένα δημόσιο web server. Αν προσπαθήσει να το συνδυάσει με την εφαρμογή σας, όλα τα αρχεία (και εικόνες (και φύλλων στυλ (και ...))) θα κάνει CHM μοιάζει με ένα δώρο από τους θεούς.


Τούτου λεχθέντος, όταν στην πραγματικότητα στο πακέτο εγκατάστασης, (αντί να εξυπηρετούνται μέσω του δικτύου), βρήκα τα αρχεία CHM να δουλέψουν καλά.


OTOH, μια άλλη παγίδα για τα αρχεία CHM: Ακόμα και αν προσπαθείτε να ανοίξετε ένα αρχείο CHM σε έναν **τοπικό** δίσκο, μπορείτε να χτύπημα σε μπλοκ ασφαλείας, αν κατεβάσει αρχικά από κάπου, επειδή το αρχείο θα μπορούσε να επισημανθεί ως «προήλθε από εξωτερική πηγή» όταν ελήφθη.

 

Είναι το ερώτημα πώς να δημιουργήσετε το δικό σας αρχεία βοήθειας, ή ποια είναι η καλύτερη μορφή αρχείου βοήθεια;


Προσωπικά, θεωρώ CHM να είναι εξαιρετική. Ένα από τα πρώτα πράγματα που κάνω κατά τη δημιουργία μιας μηχανής είναι να κατεβάσετε το εγχειρίδιο PHP σε μορφή CHM ( <http://www.php.net/download-docs.php> ) και να προσθέσετε ένα hotkey για να το [Crimson συντάκτη](http://crimsoneditor.com/) . Έτσι, όταν πατάω F1 φορτώνει το CHM και εκτελεί μια αναζήτηση για τη λέξη δρομέα μου είναι (μεγάλη για γρήγορη αναφορά λειτουργία). 

 

Το λογισμικό μας είναι τόσο διανέμονται τοπικά στους πελάτες και εξυπηρετείται από ένα κοινόχρηστο στοιχείο δικτύου. Έχουμε επιλέξει για την παραγωγή τόσο ένα αρχείο CHM και μια σειρά από αρχεία HTML για την εξυπηρέτηση από το δίκτυο. Οι χρήστες που ξεκινούν το πρόγραμμα χρησιμοποιεί τοπικά το αρχείο CHM, και οι χρήστες να πάρει το πρόγραμμά τους που εξυπηρετούνται από ένα κοινόχρηστο στοιχείο δικτύου πρέπει να χρησιμοποιήσει τα αρχεία HTML.


Χρησιμοποιούμε [βοήθεια και το εγχειρίδιο](http://www.helpandmanual.com/) και μπορεί έτσι εύκολα να παράγει δύο τύπους εξόδου από τον ίδιο έργο πηγή. Τα αρχεία HTML περιέχουν επίσης τις δυνατότητες αναζήτησης και δεν απαιτεί ένα web server, οπότε αν και δεν αποτελεί τη βέλτιστη λύση, δουλεύει μια χαρά.


Μέχρι στιγμής όλα τα είδη ενός αρχείου για τα Windows φαίνεται να σπάσει με τον ένα ή τον άλλο τρόπο:


* WinHelp - ξεπερασμένων
* HTMLHelp (CHM) - παλαιωμένο σε Vista, δεν λειτουργεί από το μερίδιο του δικτύου, εκτός από ότι λειτουργεί πραγματικά ωραία
* Η Microsoft Βοήθεια 2 (HxS) - αυτό φαίνεται να λειτουργεί μέχρι και τη στιγμή που δεν έχει, κατεστραμμένα ευρετήρια ή παρόμοια, αυτό χρησιμοποιείται από το Visual Studio 2005 και πάνω, όπως για παράδειγμα

 

Αν κάνετε «μόνο απόσπασμα και να τρέξει», θα έχετε την ευκαιρία να τρέξει σε θέματα ασφάλειας. Αυτό ισχύει ιδιαίτερα αν είστε οι χρήστες τρέχουν Vista (ή νεότερη έκδοση). είναι ένας λόγος για τον οποίο ήθελε να αποφύγει τη συσκευασία εφαρμογές σας μέσα σε ένα πρόγραμμα εγκατάστασης εκεί; Χρησιμοποιώντας ένα πρόγραμμα εγκατάστασης θα ανακουφίσει την «εξωτερική πηγή» πρόβλημα. Θα είστε σε θέση να χρησιμοποιήσετε τα αρχεία .chm χωρίς προβλήματα.


Χρησιμοποιούμε [InstallAware](http://www.installaware.com) για να δημιουργήσετε την εγκατάσταση πακέτων μας. Δεν είναι φθηνό, αλλά είναι πολύ καλό. Εάν το κόστος είναι η ανησυχία σας, [WIX](http://wix.sourceforge.net/) είναι open source και πολύ ισχυρή. WIX έχει μια καμπύλη εκμάθησης, αλλά είναι εύκολο να εργαστεί με.

 

Εάν δεν θέλετε να χρησιμοποιήσετε ένα πρόγραμμα εγκατάστασης και δεν θέλετε ο χρήστης να εκτελέσει οποιαδήποτε επιπλέον μέτρα για να επιτρέψει αρχεία CHM στο δίκτυο, γιατί να μην πέσει πίσω στο WinHelp; Vista δεν περιλαμβάνει WinHlp32.exe έξω από το κουτί, αλλά είναι [ελεύθερα διαθέσιμο ως download](http://support.microsoft.com/kb/917607) τόσο για Vista και Server 2008.

 


> 
> PDF έχει το μειονέκτημα ότι απαιτεί το Adobe Reader
> 
> 
> 


Χρησιμοποιώ [Foxit Reader](http://www.foxitsoftware.com/pdf/rd_intro.php) για τα Windows στο σπίτι και στην εργασία. Ένα πολύ μικρότερο και πολύ γρήγορο για να ανοίξει. Πολύ βολικό όταν αναρωτιέστε τι ακριβώς a80000326.pdf είναι και ο λόγος που φράζει το φάκελο των εγγράφων σας.

 

Χρησιμοποιώ ένα εμπορικό πακέτο που ονομάζεται AuthorIT που μπορεί να δημιουργήσει μια σειρά από διαφορετικές μορφές, όπως CHM, HTML, pdf, word, παράθυρα βοήθεια, xml, XHTML, και κάποιοι άλλοι που δεν έχουν ακούσει ποτέ (δεν δαχτυλίδι Dita ένα κουδούνι;). Πρόκειται για ένα σύστημα διαχείρισης περιεχομένου προσανατολισμένη προς τις ανάγκες των τεχνικών συγγραφέων τεκμηρίωσης. Το πλεονέκτημα είναι ότι μπορείτε να χρησιμοποιήσετε και την εκ νέου χρησιμοποιήσετε το ίδιο περιεχόμενο για να χτίσει μια σειρά από οδηγούς και στη συνέχεια να δημιουργήσει τους σε διάφορες μορφές.


Έτσι, η κατώτατη γραμμή σε σχέση με το θέμα της επιλογής CHM ή html ή οτιδήποτε άλλο είναι ότι εάν χρησιμοποιείτε αυτό δεν είστε εγκλωβισμένοι σε μια συγκεκριμένη μορφή, αλλά μπορεί να προσφέρει πολλά, μεταξύ των οποίων ο χρήστης μπορεί να επιλέξει, και μπορείτε να προσθέσετε ακόμη περισσότερες μορφές όσο προχωράς, χωρίς επιπλέον κόστος.


Εάν έχετε μόνο έναν οδηγό για τη δημιουργία του δεν θα αξίζει τον κόπο σας, αλλά εάν έχετε ένα φάκελο που να διαχειριστείτε τότε είναι το καλύτερο για τις γνώσεις μου. Η υποστήριξή τους είναι πολύ χρήσιμη επίσης.

 

Εξαρτάται από το πώς εισάγουμε το online τεκμηρίωση για το προϊόν σας, μια καλή υποδομή τεκμηρίωση μπορεί να είναι περίπλοκη για να δημιουργήσει, αλλά μόλις γίνει αυτό πληρώνει μακριά. Εδώ είναι πώς να το κάνουμε -


* Πηγή Βοήθεια [DITA](http://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture) compilant XML, αποθηκεύονται σε SCC (ClearCase).
* Βοηθήστε την επεξεργασία [XMetaL](http://na.justsystems.com/content.php?page=xmetal)
* Συλλογή βοήθειας, προσαρμοσμένη [Open DITA Toolkit](http://dita-ot.sourceforge.net/) , με το έθιμο Perl / Java προεπεξεργασίας
* Βοήθεια αναφορές σταυρό πηγή εφαρμογές πόρων κατά τη μεταγλώττιση, τα αρχεία .RC κ.λπ.
* Παραδοτέα Βοήθεια από την ενιαία πηγή, PDF, CHM, [Eclipse βοήθεια](http://help.eclipse.org/ganymede/index.jsp) , HTML.
* αποθετήριο μοναδική πηγή παράγει βοηθήσει για πολλά προϊόντα 10+ με χιλιάδες κοινών θεμάτων.


Από ό, τι περιγράφετε θα δούμε Eclipse Βοήθεια, δεν είναι απλό να ενταχθούν σε .NET ή MFC εφαρμογές, που βασικά πρέπει να κάνει τη χαρτογράφηση βοήθεια για την επίλυση του αιτήματος σε μια διεύθυνση URL τότε φωτιά το URL στο Eclipse Βοήθεια περιτύλιγμα ή ένα πρόγραμμα περιήγησης.

 

Πιστεύω ότι η λύση θα πάμε να καταλήξουν με για την εφαρμογή μας φιλοξενεί τη βοήθεια αρχεία τους εαυτούς μας. Αυτό μας δίνει άμεση πρόσβαση στα αρχεία και την ικανότητα να τις κρατήσει μέχρι και σήμερα. 


Αυτό που σχεδιάζουν είναι να έχουν το περιεχόμενο φορτωθεί σε μια τεράστια σειρά από αρχεία XML, κάθε ένα που περιέχει βοήθεια για ένα συγκεκριμένο θέμα. Αυτή η XML θα περιέχουν συνδέσμους σε άλλα αρχεία XML. Θα χρησιμοποιήσει XSLT για να εμφανίσετε τα περιεχόμενα ανάλογα με τις ανάγκες.


Ανάλογα με την αδειοδότηση, μπορούμε να οικοδομήσουμε ένα συγκεκριμένο πελάτη αρχείο XSLT για να προσαρμόσετε την εμφάνιση και την αίσθηση σε ό, τι χρειάζονται. Μπορεί να χρειαστεί να είναι σε θέση να δείξει μόνο βοήθεια για συγκεκριμένες εκδόσεις των προϊόντων μας, καθώς και ότι μπορεί να γίνει με φιλτράρισμα πράγματα στο XSLT.

 