Vytváření helpu - Builder.cz - Informacni server o programovani

Odběr fotomagazínu

Fotografický magazín "iZIN IDIF" každý týden ve Vašem e-mailu.
Co nového ve světě fotografie!

 

Zadejte Vaši e-mailovou adresu:

Kamarád fotí rád?

Přihlas ho k odběru fotomagazínu!

 

Zadejte e-mailovou adresu kamaráda:



Visual Basic

Vytváření helpu

help

3. dubna 2002, 00.00 | Dnešní článek bych rád věnovat tématu vytvoření helpu pro vaše aplikace. Mluvím-li o helpu mám na mysli HLP soubory — help, který se poprvé objevil ve Microsoft® Windows® 95.

Dnešní článek bych rád věnovat tématu vytvoření helpu pro vaše aplikace. Mluvím-li o helpu mám na mysli HLP soubory — help, který se poprvé objevil ve Microsoft® Windows® 95.

Rád bych upozornil céčkaře, abych tento článek neskrečovali jakmile narazí na slovo Delphi. To že se zde budu zmiňovat o Delphi, berte jen jako ukázku použití, které se v céčku zase tolik neliší. A hlavně způsob vytváření HLP souborů je absolutně nezávislí na tom v jakém jazyce programujete!

Nevím zda víte, že s vyšší verzí Delphi než je Personal či Enterprise je standardně dodáván prostředek pro tvorbu helpu — Microsoft® Help Workshop. Naneštěstí se při instalaci nevytvoří žádný link, který by o tom svědčil. Rovněž tak v nápovědě samotného produktu o to není mnoho zmínek, zda-li vůbec nějaká je.

Microsoft® Help Workshop

Tento softwarový prostředek, Microsoft® Help Workshop 4.00.0950, dokáže vytvářet standardní hlp a cnt soubory pro Win32. Slovem standardní myslím, to že vytvořený soubor vypadá stejně jako nápověda k samotnému systému, což se o některých výstupech jiných programů pro tvorbu helpu říci nedá. Tato verze programu má malinkatý nedostatek, a to rok vypuštění 1995. Což má za následek to, že vstupní RTF soubory musí být napsány nejvýše ve Wordu 6.0. Vyšší verze již nemají kompatibilní formát RTF.

Díky tomuto nedostatku je tato verze téměř nepoužitelná. Ale nenechme se odradit! Když pořádně zahrabeme na Internetu, pak najdeme novější verzi, 4.03, např. na http://www.helpmaster.com/hlp-developmentaids-hcw403.htm. A co víc tento nástroj je zdarma a podporuje RTF novějších verzí Wordu. A to nejlepší je od Microsoftu, což by mělo zaručovat 100% kompatibilitu.

Pozn.: dané RTF soubory samozřejmě můžete psát v čemkoliv co umí poznámky pod čarou s vlastními značkami, hypertextovými odkazy aj. + je kompatibilní s RTF formátem.

Tvorba RTF souboru

Tvorba dokumentů v RTF formátu bude většině zabírat největší množství času, což ovšem není způsobeno náročností zápisu potřebných značek, ale spíše tím co tam napíšete. Budete potřebovat editor, který dokáže:

  • RTF formát (s ukládáním ve „standardním kódu“ )
  • poznámky pod čarou s vlastním označením
  • skrytý text
  • dvojité podtržení
  • MS Word je pro tento účel jako stvořený. Vyzkoušel jsem je od verze 6.0 až do XP a vše bez problémů.

    Každá zobrazená karta musí mít definovány jednu resp. tři poznámky pod čarou

  • # – poznámka obsahuje název, se kterým pracuje kompilátor. Často se používají velká písmena, bez mezer, pouze v ASCII.
  • $ (nepovinné) – text (název) v této poznámce se bude zobrazovat jako název karty při vyhledávání (v helpu Index >> Find). Tato poznámka se často nepoužívá v kartách, které se zobrazují přímo z aplikace, např. nápověda při vzniklé výjimce.
  • K (nepovinné) – klíčová slova, případně i v hierarchickém uspořádání. Jednotlivá klíčová slova se oddělují středníkem a hierarchie čárkou. Názorně je to vidět v následujícím obrázku. Nejdříve se vytvoří klíčové slovo Jazyk a následně se do něj vloží podpoložky Čeština a English. Stejně jako předcházející výjimka zde se není nutné psát tuto poznámku, protože není nutné aby se informace o této kartě objevili ať již v indexu či při prohledávání.
  • Poznámky pod čarou ve Wordu

    Za těmito poznámkami pod čarou obvykle následuje vlastní text karty tj. nadpis a text. V průběhu textu můžete narazit na potřebu vytvořit odkaz na jinou kartu. Takovýto odkaz se provádí následně:

    Text, který má tvořit odkaz musí mít dvojité podtržení viz. obrázek.

    Formátování písma ve Wordu

    Dále za takto označeným textem se musí nacházet název karty (viz. poznámka pod čarou #). Tento text však musí mít jen formátování jako skrytý (viz. předchozí obrázek). Celý text vypadá takto1:

    Hypertextový odkaz na jinou kartu

    Po vytvoření HLP souboru vše bude vypadat takto:

    Hypertextový odkaz na jinou kartu

    Tvorba HLP souboru

    Spusťte si Microsoft® Help Workshop, vyberte File | New a zvolte Help Project a vyberte si soubor. V Options by bylo dobré nastavit pár věcí.

    V General zadat text do Default topic tj. některý textů v Map. Compression ve finální verzi na maximum. Sorting podle vámi preferovaného jazyka. Files zde vybrat, kam se bude ukládat výsledný HLP soubor a přidat všechny RTF soubory, které mají být v helpu, přes tlačítko Change. Případně vybrat CNT soubor, máte-li ho. Ještě by mělo být nutné opravit Fonts pro správnou češtinu.

    V Map zadáváte jednotlivé názvy, které jste dali do RTF souborů v poznámce #. Ke každé položce je nutno přidat unikátní číslo, které se vývoji aplikace dosazuje do helpContext.

    Teď již nezbývá nic jiného než zkompilovat projekt a otevřít si vytvoření HLP soubor. Případně opravit nalezené chyby či varování.

    Konec dnešního dílu. Příště si ukážeme tvorbu CNT souborů a podíváme na to, jak zařadit vytvořené HLP resp. CNT soubory do projektu ať již Delphi, C++ či Visual Basicu.


    1. – Pro zobrazení skrytého textu musíte mít zapnutý přepínač zobrazení skrytého textu tj. ¶

    Obsah seriálu (více o seriálu):

    Tématické zařazení:

     » Rubriky  » Visual Basic  

     » Rubriky  » C/C++  

     » Rubriky  » Delphi  

     » Rubriky  » Software  

     » Rubriky  » Windows  

    Diskuse k článku

     

    Vložit nový příspěvek   Sbalit příspěvky

     

    http://www.replica-handbags.co.uk

    Autor: replica handbags Muž

    Založeno: 25.02.2014, 07:44
    Odpovědí: 0

    In february my wife and I are going to Paris and we will be celebrating her birthday, as well as our first trip to the city. With that being said, her birthday gift will be a <a href="http://www.rep
    lica-handbags.co.uk"
    ><strong>Designe
    r Handbags UK</strong></a&g
    t;, but we truly don't know if we should buy it in Paris or on our New York layover on our way home. Before I go further, I will say that while my wife would love the experience of buying a <a href="http://www.rep
    lica-rolex.co">&l
    t;strong>Replica Watches</strong><
    ;/a> in Paris, she is practical and if the<a href="http://www.wat
    ches-replicas.co.uk"
    ><strong>Replica Watches UK</strong></a&g
    t; can be purchased cheaper in the US, she is going to buy it in the US.We would love to hear from some of you who have recently purchased a bagsin Paris. First, was it cheaper than it would be in the US? We are also a little confused about the VAT tax and the refund process. Also, we are under the impression that amount of goods you can bring into the united states duty free is quite low as it relates to a designer<a href="http://www.han
    dbagshermes.us">&
    lt;strong>Replica Hermes Handbags</strong>&l
    t;/a>of this nature. Bottom line, we are finding it hard go believe that buying her<a href="http://www.rep
    licaluxury.net">&
    lt;strong>Louis Vuitton handbags</strong>&l
    t;/a> in Paris will be more cost effective based on the exchange rate, VAT, and the customs allowance. If someone could break down their recent purchase for us that would be greatly appreciated. Thanks in advance!

    Odpovědět na příspěvek

     

     

    Vložit nový příspěvek

    Jméno:

    Pohlaví:

    ,

    E-mail:

    Předmět:

    Příspěvek:

     

    Kontrola:

    Do spodního pole opište z obrázku 5 znaků:

    Kód pro ověření

     

     

     

     

    Nejčtenější články
    Nejlépe hodnocené články

     

    Přihlášení k mému účtu

    Uživatelské jméno:

    Heslo: