Common Desktop Environment: Användarhandbok för systemadministratörer

Steg för att registrera "BästaTextredigerare"

Följande stegvisa procedur registrerar BästaTextredigerare.

  1. Ändra teckensnitt- och färgresurser.

    I BästaTextredigerares app-defaults-fil tar du bort resurser som anger:

    • Teckensnitt för text

    • Färger för förgrund och bakgrund

  2. Skapa programroten.

    Skapa mappen:

    	/desktop_approots/BTE

    Om du integrerar ett befintligt program bör du skapa programrotsmappen någon annanstans än på installationsplatsen för programmet. Annars kan konfigurationsfilerna som du skapar tas bort när du uppdaterar programmet.

  3. Skapa registreringspaketets mappar.

    Skapa följande mappar:

     	/desktop_approots/BTE/dt/appconfig/types/C
     	/desktop_approots/BTE/dt/appconfig/help/C
     	/desktop_approots/BTE/dt/appconfig/icons/C
     	/desktop_approots/BTE/dt/appconfig/appmanager/C/BästaTextredigerare
  4. Skapa funktionerna och datatyperna för programmet.

    1. Skapa konfigurationsfilen för funktions- och datatypsdefinitionerna:

      		/desktop_approots/BTE/dt/appconfig/types/C/BTE.dt
    2. Skapa funktionsdefinitionen för att köra BästaTextredigerare:

      		ACTION BTEditor
       		{
       				WINDOW_TYPE				NO_STDIO
       				ICON						BTERun
       				DESCRIPTION				Dubbelklicka på den här ikonen eller släpp \
       											en BTE-datafil på den för att köra \
       											BästaTextredigerare.
       				EXEC_STRING				/usr/BTE/BTEd %Arg_1%
       		}
    3. Skapa datatypen för *.bte-filer:

      		DATA_ATTRIBUTES BTEDataFile
       		{
       				DESCRIPTION				Datafil för BästaTextredigerare.
       				ICON						BTEData
       				ACTIONS					Open,Print
       		}
      
       		DATA_CRITERIA BTEDataFileCriteria1
       		{
       				DATA_ATTRIBUTES_NAME			BTEDataFile
       				NAME_PATTERN						*.bte
       				MODE									f
       		}
    4. Skapa datatypen för *.tpl-filer:

      		DATA_ATTRIBUTES BTETemplateFile
       		{
       				DESCRIPTION			Mallfil för BästaTextredigerare.
       				ICON					BTETempl
       				ACTIONS				Open
       		}
      
       		DATA_CRITERIAL BTETemplateFileCriteria1
       		{
       				DATA_ATTRIBUTES_NAME			BTETemplateFile
       				NAME_PATTERN						*.tpl
       				MODE									f
       		}
    5. Skapa Open-funktionen för *.bte-filer.

      		ACTION Open
       		{
       				ARG_TYPE			BTEDataFile
       				TYPE				MAP
       				MAP_ACTION		BTEditor
       		}
    6. Skapa Print-funktionen för *.bte-filer.

      Här följer enkla Print-funktioner som skriver ut datafiler. De här funktionerna kräver ett värde för miljövariabeln LPDEST och ignorerar utskriftsalternativet -s. (Om LPDEST inte anges kan funktionen misslyckas.)

      		ACTION Print
       		{
       				ARG_TYPE				BTEDataFile
       				TYPE					MAP
       				MAP_ACTION			BTEPrintData
       		}
      		ACTION BTEPrintData
       		{ 		WINDOW_TYPE				NO_STDIO
       				EXEC_STRING				BTEPrint -d $LPDEST %Arg_1%
       		}

      Här följer en annan version av funktionen BTEPrintData och ett medföljande skript. Tillsammans hanterar de situationer där LPDEST inte anges eller tyst utskrift begärs.

      		ACTION BTEPrintData
       		{
       				WINDOW_TYPE				NO_STDIO
       				EXEC_STRING				/usr/BTE/bin/BTEenvprint \
       											%(File)Arg_1%
       		}

      Innehållet i skriptet /usr/BTE/bin/BTEenvprint är:

      		# BTEenvprint
       		#!/bin/sh
       		DEST=""
       		SILENT=""
       		if [ $LPDEST ] ; then
       			DEST="-d $LPDEST"
       		fi
       		BTEPrint $DEST SILENT $1
    7. Skapa Open-funktionen för *.tpl-filer:

      		ACTION Open
       		{
       				ARG_TYPE			BTETemplateFile
       				TYPE				MAP
       				MAP_ACTION		BTEditor
       		}
    8. Skapa Print-funktionen för *.tpl-filer:

      		ACTION Print
       		{
       				ARG_TYPES		BTETemplateFile
       				TYPE				MAP
       				MAP_ACTION		NoPrint
       		}

      NoPrint är en inbyggd funktion som visar en dialogruta där det står att filen inte går att skriva ut.

  5. Placera hjälpfilerna i registreringspaketet.

    1. Placera hjälpfilerna på följande adresser:

       		/desktop_approots/BTE/dt/appconfig/help/C/BTEHelp.sdl
       		/desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE1.xwd
       		/desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE2.xwd
    2. Skapa filen

      		/desktop_approots/BTE/dt/appconfig/types/C/BTEhelp.dt. 

      Placera följande funktionsdefinition i filen:

      		ACTION BTEHelp
       		{
       				WINDOW_TYPE				NO_STDIO
       				EXEC_STRING				/usr/dt/bin/dthelpview -helpVolume \
       											BTEHelp.sdl
       				DESCRIPTION				Öppnar BästaTextredigerares hjälpvolym.
       		}
  6. Skapa ikoner för programmet.

    Använd Ikonredigeraren för att skapa ikonerna. Tabell 5-3 visar vilken storlek på rutnät som ska användas.

    Tabell 5-3 Rutnät för olika storlekar på ikoner

    Namn 

    Storlek 

    basnamn.t.pm

    16 gånger 16 

    basnamn.m.pm

    32 gånger 32 

    basnamn.l.pm

    48 gånger 48 

    Skapa de här ikonfilerna i mappen /desktop_approots/BTE/dt/appconfig/icons/C:

    • Ikoner som representerar funktionen som kör programmet: BTERun.t.pm, BTERun.m.pm, BTERun.l.pm

    • Ikoner som representerar *.bte-filer: BTEData.t.pm, BTEData.m.pm,

    • Ikoner som representerar *.tpl-filer: BTETempl.t.pm, BTETempl.m.pm

    • Ikoner som representerar programgruppen (används i steg 7): BTEApp.t.pm, BTEApp.m.pm

  7. Skapa programgruppen.

    1. Skapa mappen om du inte redan har gjort det.

      	/desktop_approots/BTE/dt/appconfig/appmanager/C/BästaTextredigerare
    2. Det här steget är valfritt. Det skapar en unik ikon för programgruppen genom att skapa en datatyp och associerade funktioner för programgruppen. Om du utelämnar det här steget använder programgruppen standardikonen.

      Lägg till följande datatyp- och funktionsdefinitioner i filen /desktop_approots/BTE/dt/appconfig/types/C/BTE.dt. Datatypen anger vilken ikon som ska användas av programgruppen BästaTextredigerare. Funktionerna ger samma Open- och Print-beteende som hos de inbyggda programgrupperna.

      		DATA_ATTRIBUTES BästaTextredigerareProggrupp
       		{
       				ACTIONS		OpenInPlace,OpenNewView
       				ICON			BTEApp
       		{
      		DATA_CRITERIA BästaTextredigerareProggruppVillkor
       		{
       				DATA_ATTRIBUTES_NAME	BästaTextredigerareProggrupp
       				MODE							d
       				PATH_PATTERN				*/appmanager/*/BästaTextredigerare
       		}
      		ACTION Open
       		{
       				ARG_TYPE				BästaTextredigerareProggrupp
       				TYPE					MAP
       				MAP_ACTION			OpenAppGroup
       		}
      		ACTION Print
       		{
       				ARG_TYPE				BästaTextredigerareProggrupp
       				TYPE					MAP
       				MAP_ACTION			PrintAppGroup
       		}
    3. Skapa en ikon i programgruppen som ska starta programmet. För att göra det skapar du filen:

      		/desktop_approots/BTE/dt/appconfig/appmanager/C \
       		/BästaTextredigerare/BTEditor

      och gör filen körbar.

    4. Skapa funktionsfilen i programgruppen som ska öppna hjälpvolymen. För att göra det skapar du filen:

      		/desktop_approots/BTE/dt/appconfig/appmanager/C \
       		/BästaTextredigerare/BTEHelp

      och gör filen körbar.

    5. Placera andra filer i programgruppen. Exempelvis "Readme"-filer, exempeldata och mallfiler.

  8. Registrera programmet.

    I ett terminalemuleringsfönster:

    1. Logga in som root.

    2. Kör kommandot:

      		/usr/dt/bin/dtappintegrate -s /desktop_approots/BTE
    3. Öppna programgruppen Skrivbordsverktyg och dubbelklicka på Ladda om funktioner.