HS - Formát souborů Java HelpSet

Co je soubor Java HS?

Soubor s příponou .hs v programovacím jazyce Java je soubor dokumentace nápovědy, který používá systém JavaHelp, když je aktivován aplikací. Definuje nápovědu pro konkrétní nainstalovanou aplikaci a obsahuje více podmnožin jako součást systémové nápovědy k aplikaci. Java program musí být schopen najít soubor nápovědy, jehož název končí příponou .hs.

Informace o nápovědě Java

Soubor .hs může obsahovat následující informace.

InformacePopis
Mapový souborMapový soubor se používá ke spojení ID témat s jednotným lokátorem zdrojů nebo názvem cesty k tematickým souborům v jazyce hypertextu.
Zobrazit informaceInformace, které popisují navigátory používané v sadě nápovědy. kvalitními navigátory jsou: obsah, rejstřík a fulltextové vyhledávání. mezi další navigátory patří lesk a také oblíbené navigátory. údaje týkající se uživatelských navigátorů jsou zde dále přiloženy.

Formát souborů Java HS

Soubory Java HS jsou ve formátu XML a jsou založeny na doporučení navrženém konsorciem World Wide Web Consortium (W3C) Extended Markiup Language PR-xml-971208. To znamená, že soubor Java HS je ve formátu souboru XML čitelném pro člověka, který lze otevřít v jakékoli aplikaci pro čtení XML.

Příklad formátu souboru Java HS

Níže je uveden příklad souboru nápovědy z dokumentace sady nápovědy Oracle.

<?xml version='1.0' encoding='ISO-8859-1' ?>
<!DOCTYPE helpset
  PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp HelpSet Version 2.0//EN"
         "http://java.sun.com/products/javahelp/helpset_2_0.dtd">
<helpset version="2.0">
   <!-- title -->
   <title>Java Development Environment - Help</title>

   <!-- maps -->
   <maps>
     <homeID>top </homeID>
     <mapref location="Map.jhm" />
   </maps>

   <!-- views -->
   <view xml:lang="en" mergetype="javax.help.UniteAppendMerge">
      <name>TOC</name>
      <label>Table Of Contents</label>
      <type>javax.help.TOCView</type>
      <data>IdeHelpTOC.xml</data>
   </view>

   <view xml:lang="en" mergetype="javax.help.SortMerge">
      <name>Index</name>
      <label>Index</label>
      <type>javax.help.IndexView</type>
      <data>IdeHelpIndex.xml</data>
   </view>

   <view xml:lang="en">
      <name>Search</name>
      <label>Search</label>
      <type>javax.help.SearchView</type>
         <data engine="com.sun.java.help.search.DefaultSearchEngine">
         JavaHelpSearch
         </data>
   </view>

   <!-- A glossary navigator -->
   <view  mergetype="javax.help.SortMerge">
      <name>glossary</name>
      <label>Glossary</label>
      <type>javax.help.GlossaryView</type>
      <data>glossary.xml</data>
   </view>

   <!-- A favorites navigator -->
   <view>
      <name>favorites</name>
      <label>Favorites</label>
      <type>javax.help.FavoritesView</type>
   </view>

   <!-- presentation windows -->

   <!-- This window is the default one for the helpset.
     *  Its title bar says "Project X Help". It
     *  is a tri-paned window because displayviews, not
     *  defined, defaults to true and because a toolbar is defined.
     *  The toolbar has a back arrow, a forward arrow, and
     *  a home button that has a user-defined image.
   -->
   <presentation default=true>
       <name>main window</name>
       <size width="400" height="400" />
       <location x="200" y="200" />
       <title>Project X Help</title>
       <toolbar>
           <helpaction>javax.help.BackAction</helpaction>
           <helpaction>javax.help.ForwardAction</helpaction>
           <helpaction image="homeicon">javax.help.HomeAction</helpaction>
       </toolbar>
   </presentation>

   <!-- This window is simpler than the main window.
     *  It's intended to be used a secondary window.
     *  It has no navigation pane or toolbar.
   -->
   <presentation displayviews=false>
       <name>secondary window</name>
       <size width="200" height="200" />
       <location x="200" y="200" />
   </presentation>

   <!-- subhelpsets -->
   <subhelpset location="file:/c:/Foobar/HelpSet2.hs" />

   <!-- implementation section -->
   <impl>
      <helpsetregistry helpbrokerclass="javax.help.DefaultHelpBroker" />
      <viewerregistry viewertype="text/html"
         viewerclass="com.sun.java.help.impl.CustomKit />
      <viewerregistry viewertype="text/xml"
         viewerclass="com.sun.java.help.impl.CustomXMLKit />
   </impl>
</helpset>

Reference

HS - Haskell Script File Format

Co je soubor HS?

Soubor s příponou .hs je soubor Haskell Script, který je napsán v Haskell, pokročilém čistě funkčním open-source programovacím jazyce. Kód napsaný v HS souboru je založen čistě na funkcích, na rozdíl od C, C++ a podobně, které se řídí principy rychlého vývoje robustního a stručného softwaru. Haskell poskytuje vestavěnou souběžnost a paralelismus spolu s bohatými API, profilery a debuggery pro vytváření flexibilních a vysoce kvalitních aplikací.

Formát souboru HS

Jako každý programovací jazyk jsou soubory HS psány ve formátu prostého textu, který je čitelný pro člověka. Ty lze vytvářet, upravovat a prohlížet pomocí jakýchkoli dostupných textových nástrojů. Soubor zdrojového kódu .hs je zkompilován pomocí kompilátoru Haskell, který generuje spustitelný binární soubor.

Příklad formátu souboru HS

Kód lze zapsat do souboru .hs a zkompilovat pomocí kompilátoru Haskell, jako je GHC. Následující řádek kódu je uložen jako „HelloWorld.hs“, jak je znázorněno v následující ukázce.

main = putStrLn "Hello, World!"

To se zkompiluje pomocí příkazu:

$ ghc -o hello hello.hs

a výsledný spustitelný soubor lze spustit jako:

$ ./hello

Tím se vytiskne nápis “Ahoj, světe!” prohlášení k výstupu.

Reference

See Also