HS - Java HelpSet File Format

Vad är en Java HS fil?

En fil med filändelsen .hs i programmeringsspråket Java är en hjälpdokumentationsfil som används av JavaHelp-systemet när den aktiveras av en applikation. Den definierar hjälpmängden för den speciella applikationen som är installerad och består av flera delmängder som en del av systemhjälpen för applikationen. Java-programmet måste kunna hitta hjälpuppsättningsfilen vars namn slutar med tillägget .hs.

Java Helpset Information

En .hs-fil kan innehålla följande information.

InformationBeskrivning
Map FileKartfilen används för att associera ämnes-ID:n med den enhetliga resurslokaliseraren eller sökvägen för ämnesfiler för hypertextmarkeringsspråk.
Visa informationInformation som beskriver de navigatörer som används i hjälpsetet. kvalitetsnavigatorerna är: innehållsförteckning, index och fulltextsökning. ytterligare navigatorer inkluderar glansen och även favoritnavigatorerna. data om anpassade navigatorer bifogas här ytterligare.

Java HS filformat

Java HS-filerna är i XML-filformat och är baserade på World Wide Web Consortium (W3C) Extended Markiup Language föreslagen rekommendation PR-xml-971208. Detta innebär att en Java HS-fil är i mänskligt läsbart XML-filformat som kan öppnas i alla XML-läsarapplikationer.

Exempel på Java HS-filformat

Följande är ett exempel på en hjälpuppsättningsfil från Oracle Helpset-dokumentation.

<?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>

Referenser

HS - Haskell Script filformat

Vad är HS fil?

En fil med tillägget .hs är en Haskell Script-fil som är skriven i Haskell, ett avancerat rent funktionellt programmeringsspråk med öppen källkod. Kod skriven i HS-fil är enbart baserad på funktioner, till skillnad från C, C++ och liknande, som följer principerna för snabb utveckling av robust och koncis mjukvara. Haskell tillhandahåller inbyggd samtidighet och parallellitet tillsammans med rika API:er, profilerare och debuggers för att producera flexibla och högkvalitativa applikationer.

HS filformat

Som alla programmeringsspråk är HS-filer skrivna i vanligt textformat som är läsbara för människor. Dessa kan skapas, redigeras och visas med alla tillgängliga textverktyg. Källkodsfilen .hs kompileras med en Haskell-kompilator som genererar den körbara binära filen.

Exempel på HS-filformat

Koden kan skrivas i en .hs-fil och kompileras med en Haskell-kompilator som t.ex. GHC. Följande kodrad sparas som HelloWorld.hs som visas i följande exempel.

main = putStrLn "Hello, World!"

Detta kompileras med kommandot:

$ ghc -o hello hello.hs

och den resulterande körbara filen kan köras som:

$ ./hello

Detta trycker “Hello, World!” uttalande till utgången.

Referenser

See Also