6.12. admonitions:note,caution,warning,tip和important

Docbook中有个一系列的术语叫做admonitions,包含了note,caution,warning,tip和important

6.12.1. note

例 6.27. note举例


<note xml:id="note.install_java_first"><title>如果没有安装java,请先安装java</title>
    <para>fop的运行,依赖于java运行环境。</para>
    <para>如果你的windows中,还没有安装java,请先安装java运行环境(JRE=java runtime environment)。</para>
    <para>关于java的基本知识和如何安装,不了解的请参考:<link xl:href="http://www.crifan.com/files/doc/docbook/soft_dev_basic/release/html/soft_dev_basic.html#java">Java</link></para>
    <para>java已经安装好前提下,另外记得确保JAVA_HOME环境变量已经正确设置好了。</para>
    <para>比如,我的系统中的是:</para>
    <screen>JAVA_HOME=D:\Program Files\Java\jre7</screen>
</note>

                

6.12.2. caution

例 6.28. caution举例


<caution xml:id="not_make_ldflags_lintl_lcurses"><title>此处不要通过make时加LDFLAGS参数去添加-lintl和-lcurses</title>
    <para>其实,上面贴出来的,修改makefile的办法,的确已经解决了此处的,缺少intl和缺少ncurses的库的两个问题了。</para>
    <para>只是,后来,在另外一个Cygwin环境下去折腾同样的make编译crosstool-ng的时候:</para>
    <para><link xl:href="http://www.crifan.com/cygwin_crosstool_ng_configure_make_make_install">【记录】Cygwin下配置编译和安装crosstool-ng</link></para>
    <para>由于之前解决上面这个问题的时候:</para>
    <para><link xl:href="http://www.crifan.com/crosstool_ng_cygwin_zconf_tab_o_zconf_tab_c_text_0x162a_undefined_reference_to_libintl_gettext-2/">【已解决】Cygwin 1.7.17下make编译crosstool-ng出错:zconf.tab.o:zconf.tab.c:(.text+0x162a): undefined reference to `_libintl_gettext'</link></para>
    <para>用的解决办法是:</para>
    <para>不去修改makefile,而直接给make加上LDFLAGS参数加上-lintl:</para>
    <screen>make LDFLAGS="-lintl"</screen>
    <para>当时也是可以解决此问题的。</para>
</caution>

                

6.12.3. warning

6.12.4. tip

例 6.29. tip举例


<tip xml:id="tip.how_set_win_env"><title>如何设置windows环境变量</title>
    <para>关于如何添加相应路径到windows的环境变量中,不熟悉的可以参考:</para>
    <para><link xl:href="http://www.crifan.com/files/doc/docbook/soft_dev_basic/release/html/soft_dev_basic.html#win_env_var">Windows的环境变量</link></para>
</tip>

                

6.12.5. important