soubory nápovědy Windows - jaké jsou možnosti?

hlasů
34

Po návratu do starých časů, Help nebylo triviální, ale je to možné: vytvářet nějaké funky RTF soubor se speciálními značkami, spusťte jej pomocí překladače, a máte soubor WinHelp (HLP), který skutečně funguje opravdu dobře.

Potom, Microsoft se rozhodl, že WinHelp nebyl hip a cool a už přešel k CHM, a to až do té míry, že skutečně axed WinHelp od Vista.

Nyní, CHM možná pěkné, ale každý, kdo se pokusili otevřít soubor CHM v síti budou znát krásný „Navigace na webovou stránku byla zrušena“ displej, který je způsoben omezením zabezpečení.

I když existují způsoby, jak CHM odpracovat síť, to je stěží dobrá volba, protože když uživatel stiskne tlačítko Help chce pomáhat a nebudou se muset udělat nějaké funky nastavení.

Sečteno a podtrženo: Zjistil jsem, CHM naprosto nepoužitelný. Ale s WinHelp není možnost už ani by mě zajímalo, jaké jsou alternativy, a to zejména pokud jde o integraci s mou žádost (tj pro WinHelp a CHM existují funkce, které vám umožní přímo přejít na téma)?

PDF má tu nevýhodu, že vyžaduje Adobe Reader (nebo jeden z těch lehkých, že ne mnoho lidí používají). Mohl bych žít s tímto viděním, protože to je druh standardu v dnešní době, ale můžete jej říci spolehlivě přejít na danou stránku / kotvy?

HTML soubory se zdají být tou nejlepší volbou, pak jen budou muset vypořádat s různými prohlížeči (CSS a tak).

Edit: Těším se vytvořit vlastní soubory nápovědy. Protože jsem fanoušek „Žádné nastavení, Just Extract and Run“ filozofie, jsem měl tento problém mnohokrát v minulosti, protože mnoho z mých uživatelů bude moci rozběhat sítě, který způsobuje právě tento problém.

Takže jsem hledal více robustní a budoucí-důkaz způsob, jak zajistit pomoc pro naše uživatele, aniž byste museli kód jiný systém nápovědy pro každou aplikaci udělám.

CHM je opravdu pěkný formát, ale to Bezpečnostní Stuff činí nepoužitelnou, protože systém nápovědy má poskytnout pomoc pro uživatele, nikoli pro vytvoření ještě větší problémy.

Položena 04/08/2008 v 11:43
zdroj uživatelem
V jiných jazycích...                            


10 odpovědí

hlasů
15

HTML by se příští nejlepší volbou, pouze tehdy, pokud by se jim sloužit z veřejného webového serveru. Pokud jste se pokusili to svazek s vaší aplikací, všechny soubory (a obrázky (a styly (a ...))) by CHM vypadat jako dar od bohů.

To znamená, že když vlastně svázaný v instalačním balíčku, (místo toho, aby sloužil přes síť), zjistil jsem, že soubory CHM k práci dobře.

OTOH další past o CHM souborů: I když se pokusíte otevřít soubor CHM na lokálním disku, můžete narazit do bezpečnostního bloku, pokud jej nejprve stáhnout odněkud, protože soubor mohl být označen jako „přišel z externího zdroje“ kdy byl získán.

Odpovězeno 04/08/2008 v 11:51
zdroj uživatelem

hlasů
5

Nemám rád možnost html, a ve skutečnosti přesunul z prostého HTML CHM kompresi a jejich indexování. Dokonce použít na hrstku zákazníků než Windows sudých. Jednoduše řešeno neustálé málo rozbití osob uvedení jej v síti (hloubka vnoření omezené, podivné zamykání účinků), antivirovým, který zemřel v adresářích s 30000 html soubory a 20 minut dekompresní čas při instalaci na starším systému, bezpečnostních prohlížeč zón a rysy, chybné výpočty potřebného prostoru v instalačním atd.

A pak jsem se nezahrnují ani lidi, kteří začnou „opravuje“ je, produkt 3. strany s vadnými „integrace“ pokusy etc, stížností slowliness (prohlížeč start-up)

Měli jsme všichni čekali roky za problémy jít pryč jako operační systémy a hardware lepších, ale problémy se stále opakovaly v bedazzling počtu odrůd a už toho bylo dost. Zjistili jsme chmlib, a rozhodli jsme se mohli věčně použít něco založený na to jako útěk s jednoduchým externí čtečku, pokud ty jsou poskytovány OS přestal pracovat a zapnutý.

Mezitím máme také vlastní kompilátor, takže jsme MS zdarma budoucnost odolné. To neznamená, že bychom se nikdy změní (roztoky s místními webovými servery zdát oblíbený v dnešní době), ale alespoň máme na výběr.

Odpovězeno 06/09/2009 v 01:03
zdroj uživatelem

hlasů
3

Záleží na tom, jak importovat online dokumentace pro váš produkt, dobrá dokumentace infrastruktura může být složité zjistit, ale jakmile udělal to vyplatí. Zde je, jak to děláme -

  • Zdroj Help DITA compilant XML, uložené v SCC (ClearCase).
  • Pomoci editace XMetal
  • Kompilace nápovědu, která je uzpůsobena Otevřít DITA Toolkit s vlastní Perl / Java předzpracování
  • Pomoc zdroj cross reference aplikace zdroje v době kompilace, .rc soubory atd
  • Pomoc výstupy z jediného zdroje, PDF, CHM, Eclipse Help , HTML.
  • Jediný zdroj úložiště produkuje nápovědu pro více produktů 10 a více s tisíci společných témat.

Z toho, co jsi popsal bych se podívat na Eclipse Help, není to jednoduché integrovat do .NET nebo MFC aplikace, jste v podstatě muset udělat mapování pomoci vyřešit požadavek na adresu URL a pak oheň URL Eclipse Help obal nebo prohlížeč.

Odpovězeno 21/09/2008 v 01:11
zdroj uživatelem

hlasů
3

Pokud si nechcete používat instalační program a nechcete, aby uživatel provádět žádné další kroky, aby umožnily soubory CHM přes síť, tak proč ne klesnout zpět na WinHelp? Vista neobsahuje WinHlp32.exe po vybalení z krabice, ale je volně k dispozici ke stažení pro oba Vista a Server 2008.

Odpovězeno 04/08/2008 v 14:48
zdroj uživatelem

hlasů
3

Náš software je distribuován jak lokálně klientům a sloužil ze sdílené síťové. Rozhodli jsme se pro generování jak soubor CHM a sadu HTML souborů pro servírování ze sítě. Uživatelé Spuštění programu lokálně pomocí souboru CHM, a uživatelé dostat svůj program sloužil ze sdílené síťové musí používat soubory ve formátu HTML.

Používáme nápovědy a příručky a mohou tak snadno vyrobit oba typy výstupů ze stejného zdroje projektu. HTML soubory také obsahovat pátravé schopnosti a nevyžaduje webový server, takže i když to není optimální řešení, funguje dobře.

Doposud všechny typy single-souborů pro Windows se zdá být rozbita v tak či onak:

  • WinHelp - zastarán
  • HtmlHelp (CHM) - zastaralé v systému Vista, nefunguje ze sdílené síťové jiný než který funguje opravdu pěkné
  • Microsoft Help 2 (HXS) - zdá se, že funguje až do okamžiku, kdy se tak nestane, poškozené indexy nebo podobné, to je používán Visual Studio 2005 a výše, jako například
Odpovězeno 04/08/2008 v 12:02
zdroj uživatelem

hlasů
3

Je otázka, jak vytvářet své vlastní soubory nápovědy, nebo to, co je nejlepší formát soubor nápovědy?

Osobně považuji CHM být vynikající. Jedna z prvních věcí, které jsem si při nastavování stroje je ke stažení Manuál PHP ve formátu CHM ( http://www.php.net/download-docs.php ) a přidat klávesové zkratky k ní v Crimson Editor . Takže když jsem stisknutím klávesy F1 načte CHM a provádí pátrání po slovu můj kurzor na (ideální pro rychlou orientaci funkce).

Odpovězeno 04/08/2008 v 11:52
zdroj uživatelem

hlasů
2

Myslím, že řešení budeme skončit jít se pro naše aplikace hostit pomoc soubory sami. To nám dává okamžitý přístup k souborům a schopnost držet je až do dnešního dne.

To, co jsem v plánu je, že se obsah načtený do obrovské řady XML souborů, každý z nich, který obsahuje nápovědu pro konkrétní položky. Tento XML bude obsahovat odkazy na jiné soubory ve formátu XML. Rádi bychom použít XSLT k zobrazení obsahu podle potřeby.

V závislosti na vydávání licencí, můžeme vytvořit soubor XSLT klienta specifické, aby se přizpůsobit vzhled a to, co potřebují. Budeme muset být schopni prokázat jen pomoc pro jednotlivé verze našeho produktu, jak dobře a že lze provést odfiltrování věci v XSLT.

Odpovězeno 27/11/2008 v 21:39
zdroj uživatelem

hlasů
2

PDF má tu nevýhodu, že vyžaduje Adobe Reader

I používat Foxit Reader na Windows doma i v práci. Mnoho menších a velmi rychle otevřít. Velmi užitečné, když jste přemýšlel, co přesně a80000326.pdf je a proč je ucpání složce Dokumenty.

Odpovězeno 05/08/2008 v 19:55
zdroj uživatelem

hlasů
2

Pokud děláte „jen rozbalit a spustit“, budete spouštět v bezpečnostních otázkách. To platí zejména, pokud jste uživatelé se systémem Vista (nebo novější). Je nějaký důvod, proč byste chtěli, aby se zabránilo obalových aplikací uvnitř instalačního programu? Pomocí instalačního programu by zmírnilo „externí zdroj“ problém. Měli byste být schopni používat CHM soubory bez jakýchkoliv problémů.

Používáme InstallAware vytvořit své instalaci balíčků. Není to levné, ale je velmi dobrá. Pokud cena je vaše starost, WIX je open source a dost robustní. WIX přece má křivku učení, ale je to snadné s ním pracovat.

Odpovězeno 04/08/2008 v 13:11
zdroj uživatelem

hlasů
1

I používat obchodní balík s názvem AuthorIT, který umí generovat celou řadu různých formátů, například CHM, HTML, PDF, slovo, okna pomoc, XML, XHTML, a některé další Nikdy jsem neslyšel (dělá Dita neříká?). Jedná se o systém pro správu obsahu orientován na potřeby technických spisovatelů dokumentace. Výhodou je, že můžete použít a znovu používat stejný obsah vytvořit sadu příruček, a pak generovat je v různých formátech.

Takže spodním řádku ve vztahu k otázce výběru CHM nebo HTML nebo cokoliv je to, že pokud používáte tento nejste omezeni na daném formátu, ale může poskytnout několik, mezi kterými si může uživatel zvolit, a můžete přidat i další formáty za pochodu, a to bez dodatečných nákladů.

Pokud stačí jedno vodítko k vytvoření to nebude za váš čas, ale pokud máte dokumentaci určený pro řízení pak je to nejlepší, pokud je mi známo. Jejich podpora je také velmi užitečná.

Odpovězeno 18/09/2008 v 15:47
zdroj uživatelem

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more