z72.html

gtk 开发手册和参考文档。 包括gtk glib gdk等

SGML_FILES =                    \
        gnome-hello.sgml

# files that aren't in a binary/data/library target have to be listed here
# to be included in the tarball when you 'make dist'
EXTRA_DIST = \
        topic.dat               \
        $(SGML_FILES)


## The - before the command means to ignore it if it fails.  that way
## people can still build the software without the docbook tools

all: 

gnome-hello.html: gnome-hello/gnome-hello.html
    -cp gnome-hello/gnome-hello.html .

gnome-hello/gnome-hello.html: $(SGML_FILES)
    -db2html gnome-hello.sgml

## when we make dist, we include the generated HTML so people don't
## have to have the docbook tools
dist-hook:
    mkdir $(distdir)/gnome-hello
    -cp gnome-hello/*.html gnome-hello/*.css $(distdir)/gnome-hello
    -cp gnome-hello.html $(distdir)

install-data-local: gnome-hello.html
    $(mkinstalldirs) $(gnome_hello_helpdir)/images
    -for file in $(srcdir)/gnome-hello/*.html $(srcdir)/gnome-hello/*.css; do \
    basefile=`basename $$file`; \
    $(INSTALL_DATA) $(srcdir)/$$file $(gnome_hello_helpdir)/$$basefile; \
    done

gnome-hello.ps: gnome-hello.sgml
    -db2ps $<

gnome-hello.rtf: gnome-hello.sgml       
    -db2rtf $<


</pre>
              </td>
            </tr>
          </table>
          <p>
            In particular notice the install directory for the
            generated HTML files: <tt class="APPLICATION">
            $(datadir)/gnome/help/gnome-hello/C</tt>. The Gnome
            libraries look for help here. Each application's help
            goes in its own directory under <tt class=
            "APPLICATION">$(datadir)/gnome/help</tt>. Each locale's
            documentation is installed in its own subdirectory of
            the application directory. Other rules in <tt class= 
            "FILENAME">Makefile.am</tt> run the DocBook-to-HTML
            converter, include HTML in the distribution tarball,
            and create PostScript and Rich Text Format targets.
            (Users can create PostScript by typing <tt class= 
            "APPLICATION">make gnome-hello.ps</tt> explicitly.)
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="SEC-.DESKTOP"><tt class="APPLICATION">
          .desktop</tt> Entries</a>
        </h2>
        <p>
          Gnome programs come with "<tt class=
          "APPLICATION">.desktop</tt> entries," which are simply
          small files describing how the application should appear
          in menus. Installing a <tt class="APPLICATION">
          .desktop</tt> entry causes your application to show up in
          the Gnome panel menu. Here is <tt class="FILENAME">
          gnome-hello.desktop</tt>:
        </p>
        <table border="0" bgcolor="#E0E0E0" width="100%">
          <tr>
            <td>
<pre class="PROGRAMLISTING">
&#13;[Desktop Entry]
Name=Gnome Hello
Name[es]=Gnome Hola
Name[fi]=GNOME-hei
Name[gl]=Ola GNOME
Name[no]=Gnome hallo
Name[sv]=Gnome Hej
Name[pl]=Halo GNOME
Comment=Hello World
Comment[es]=Hola Mundo
Comment[fi]=Hei, maailma
Comment[gl]=Ola Mundo
Comment[sv]=Hej V&auml;rlden
Comment[no]=Hallo verden
Comment[pl]=Witaj &para;wiecie
Exec=gnome-hello
Icon=gnome-hello-logo.png
Terminal=0
Type=Application
&#13;
</pre>
            </td>
          </tr>
        </table>
        <p>
          The file consists of key-value pairs. The <tt class= 
          "APPLICATION">Name</tt> key specifies the name of your
          application in the default (<tt class=
          "APPLICATION">C</tt>) locale; any key can have
          translations with a locale appended in brackets, such as
          <tt class="APPLICATION">Name[es]</tt>. The <tt class= 
          "APPLICATION">Comment</tt> key is a "tooltip" or hint
          describing the application in more detail. <tt class= 
          "APPLICATION">Exec</tt> is the command line to use to
          execute the program. <tt class="APPLICATION">
          Terminal</tt> is a boolean value; if non-zero, the
          program will be run inside a terminal. <tt class= 
          "APPLICATION">Type</tt> should always be "Application" in
          this context.
        </p>
        <p>
          Installing a <tt class="APPLICATION">.desktop</tt> entry
          is simple; here is the toplevel <tt class="FILENAME">
          Makefile.am</tt> from GnomeHello again:
        </p>
        <table border="0" bgcolor="#E0E0E0" width="100%">
          <tr>
            <td>
<pre class="PROGRAMLISTING">
&#13;SUBDIRS = macros po intl src pixmaps doc

## We dist autogen.sh since this is an example program
## Real-world programs do not need to distribute autogen.sh
EXTRA_DIST = \
        gnome-hello.desktop \
    autogen.sh

Applicationsdir = $(datadir)/gnome/apps/Applications
Applications_DATA = gnome-hello.desktop
&#13;
</pre>
            </td>
          </tr>
        </table>
        <p>
          Notice that there is a directory tree under <tt class= 
          "APPLICATION">$(datadir)/gnome/apps/</tt> with
          subdirectories that arrange programs into categories.
          GnomeHello installs itself in the "Applications"
          category; other programs might choose "Games,"
          "Graphics," "Internet," or whatever is appropriate. Try
          to choose a category that already exists, rather than
          inventing your own.
        </p>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="SEC-EXTRADIST"><tt class="APPLICATION">
          EXTRA_DIST</tt></a>
        </h2>
        <p>
          The <tt class="APPLICATION">EXTRA_DIST</tt> variable in a
          <tt class="FILENAME">Makefile.am</tt> lists files to be
          included in the distribution (tarball). Most important
          files are automatically included; for example, all files
          listed as source files for binaries or libraries.
          However, <tt class="APPLICATION">automake</tt> does not
          know about <tt class="APPLICATION">.desktop</tt> files,
          or SGML documentation; so these files must be listed in
          <tt class="APPLICATION">EXTRA_DIST</tt>. <tt class= 
          "APPLICATION">make distcheck</tt>'s attempt to build the
          distribution will normally fail if you leave files out of
          <tt class="APPLICATION">EXTRA_DIST</tt>.
        </p>
      </div>
    </div>
    <div class="NAVFOOTER">
      <br>
      <br>
      <table width="100%" border="0" bgcolor="#ffffff" cellpadding= 
      "1" cellspacing="0">
        <tr>
          <td width="25%" bgcolor="#ffffff" align="left">
            <a href="z71.html"><font color="#0000ff" size="2"><b>
            &lt;&lt;&lt; Previous</b></font></a>
          </td>
          <td width="25%" colspan="2" bgcolor="#ffffff" align= 
          "center">
            <font color="#0000ff" size="2"><b><a href="ggad.html">
            <font color="#0000ff" size="2"><b>
            Home</b></font></a></b></font>
          </td>
          <td width="25%" bgcolor="#ffffff" align="right">
            <a href="cha-startup.html"><font color="#0000ff" size=
            "2"><b>Next &gt;&gt;&gt;</b></font></a>
          </td>
        </tr>
        <tr>
          <td colspan="2" align="left">
            <font color="#000000" size="2"><b>Relevant GNU
            Documentation</b></font>
          </td>
          <td colspan="2" align="right">
            <font color="#000000" size="2"><b>Gnome Application
            Basics</b></font>
          </td>
        </tr>
      </table>
    </div>
  </body>
</html>