allow automated publishing; switch to ./resources/

The additional programs and content were stored in a directory called
ncurses_programs and were referred to in the document--the problem is that
only ./images/ were copied to the output tree, so HTML versions of the
document would fail in building AND the files would not be viewable.

Adjusted that be creating a ./resources/ directory along the same line
as the ./images/ directory.  This can be changed, if desired, but this
allows for automated publication of the document.  (Side benefit: this is
generalizable to all other TLDP documents.)
This commit is contained in:
Martin A. Brown 2016-01-25 09:28:17 -08:00
parent 3b3973c134
commit bd48a44b6a
66 changed files with 36 additions and 34 deletions

View File

@ -288,7 +288,7 @@ each of the examples.
<sect2 id="aboutprograms"><title>About the Programs</title>
<para>
All the programs in the document are available in zipped form
<ulink url="http://www.tldp.org/HOWTO/NCURSES-Programming-HOWTO/ncurses_programs.tar.gz">
<ulink url="http://www.tldp.org/HOWTO/NCURSES-Programming-HOWTO/resources/ncurses_programs.tar.gz">
here</ulink>. Unzip and untar it. The directory structure looks like this.
</para>
@ -391,8 +391,8 @@ examples directory.
<simpara> If you prefer browsing individual programs, point your browser to
<ulink
url="http://tldp.org/HOWTO/NCURSES-Programming-HOWTO/ncurses_programs/">
http://tldp.org/HOWTO/NCURSES-Programming-HOWTO/ncurses_programs/
url="http://tldp.org/HOWTO/NCURSES-Programming-HOWTO/resources/ncurses_programs/">
http://tldp.org/HOWTO/NCURSES-Programming-HOWTO/resources/ncurses_programs/
</ulink></simpara>
<para>
@ -448,7 +448,7 @@ If above links are broken or if you want to experiment with sgml read on.
http://cvsview.tldp.org/index.cgi/LDP/howto/docbook/
NCURSES-HOWTO/NCURSES-Programming-HOWTO.sgml
http://cvsview.tldp.org/index.cgi/LDP/howto/docbook/
NCURSES-HOWTO/ncurses_programs.tar.gz
NCURSES-HOWTO/resources/ncurses_programs.tar.gz
Unzip ncurses_programs.tar.gz with
tar zxvf ncurses_programs.tar.gz
@ -602,7 +602,7 @@ program with ncurses the flag -lncurses should be added.
<example id="bhw"> <title> The Hello World !!! Program </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/hello_world.c">
fileref="resources/ncurses_programs/basics/hello_world.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -768,7 +768,7 @@ Let's write a program which will clarify the usage of these functions.
<example id="binfu"> <title> Initialization Function Usage example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/init_func_example.c">
fileref="resources/ncurses_programs/basics/init_func_example.c">
</imageobject></inlinemediaobject></programlisting>
</example>
<para>
@ -997,7 +997,7 @@ be used when variable number of arguments are to be printed.
<example id="bprex"> <title> A Simple printw example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/printw_example.c">
fileref="resources/ncurses_programs/basics/printw_example.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -1121,7 +1121,7 @@ the user.
<example id="bscex"> <title> A Simple scanw example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/scanw_example.c">
fileref="resources/ncurses_programs/basics/scanw_example.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -1138,7 +1138,7 @@ and prints the file with comments in bold. Scan through the code.
<example id="bsiat"> <title> A Simple Attributes example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/simple_attr.c">
fileref="resources/ncurses_programs/basics/simple_attr.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -1230,7 +1230,8 @@ policy and stick to it. You can always use <literal remap="tt"> standend()
</para>
</sect2>
<sect2 id="attr_get"><title>attr_get()</title>
<!-- jade forbids underscore in id="" attribute; thus attr-get -->
<sect2 id="attr-get"><title>attr_get()</title>
<para>
@ -1244,7 +1245,8 @@ desired effect.
</para>
</sect2>
<sect2 id="attr_funcs"><title>attr_ functions</title>
<!-- jade forbids underscore in id="" attribute; thus attr-funcs -->
<sect2 id="attr-funcs"><title>attr_ functions</title>
<para>
There are series of functions like attr_set(), attr_on etc.. These are similar
to above functions except that they take parameters of type
@ -1295,7 +1297,7 @@ are macros.
<example id="bwich"> <title> Chgat() Usage example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/with_chgat.c">
fileref="resources/ncurses_programs/basics/with_chgat.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -1346,7 +1348,7 @@ window. Let's explore these functions in more detail in this example.
<example id="bwibo"> <title>Window Border example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/win_border.c">
fileref="resources/ncurses_programs/basics/win_border.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -1426,7 +1428,7 @@ length at the specified position.
<example id="botbo"><title> More border functions</title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/other_border.c">
fileref="resources/ncurses_programs/basics/other_border.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -1441,7 +1443,7 @@ Let's get into the thick of the things with a small program.
<example id="bsico"> <title> A Simple Color example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/simple_color.c">
fileref="resources/ncurses_programs/basics/simple_color.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -1586,7 +1588,7 @@ and down arrows.
<example id="bsike"><title> A Simple Key Usage example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/simple_key.c">
fileref="resources/ncurses_programs/basics/simple_key.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -1713,7 +1715,7 @@ mouse interaction. To make things simpler, key handling is removed.
<example id="bmome"> <title> Access the menu with mouse !!! </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/mouse_menu.c">
fileref="resources/ncurses_programs/basics/mouse_menu.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -1842,7 +1844,7 @@ is an example showing the sequence of things to be done.
<example id="btele"> <title> Temporarily Leaving Curses Mode </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/temp_leave.c">
fileref="resources/ncurses_programs/basics/temp_leave.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -1861,7 +1863,7 @@ showing all the characters.
<example id="bacsvars"> <title> ACS Variables Example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/basics/acs_vars.c">
fileref="resources/ncurses_programs/basics/acs_vars.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -1985,7 +1987,7 @@ program with panels library the flag -lpanel should be added along with
<example id="ppasi"><title> Panel basics</title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/panels/panel_simple.c">
fileref="resources/ncurses_programs/panels/panel_simple.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -2006,7 +2008,7 @@ windows which can be cycled through using tab. Have a look at the code.
<example id="ppabr"><title> Panel Window Browsing Example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/panels/panel_browse.c">
fileref="resources/ncurses_programs/panels/panel_browse.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -2055,7 +2057,7 @@ operations.
<example id="ppare"><title> Panel Moving and Resizing example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/panels/panel_resize.c">
fileref="resources/ncurses_programs/panels/panel_resize.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -2108,7 +2110,7 @@ hidden or not is not working. A bug report was also presented by Michael Andres
<example id="ppahi"><title> Panel Hiding and Showing example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/panels/panel_hide.c">
fileref="resources/ncurses_programs/panels/panel_hide.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -2212,7 +2214,7 @@ in that order.
<example id="mmesi"> <title>Menu Basics </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/menus/menu_simple.c">
fileref="resources/ncurses_programs/menus/menu_simple.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -2373,7 +2375,7 @@ a border and a title.
<example id="mmewi"><title> Menu Windows Usage example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/menus/menu_win.c">
fileref="resources/ncurses_programs/menus/menu_win.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -2398,7 +2400,7 @@ scrolling. Let's see how it can be done.
<example id="mmesc"><title> Scrolling Menus example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/menus/menu_scroll.c">
fileref="resources/ncurses_programs/menus/menu_scroll.c">
</imageobject></inlinemediaobject></programlisting>
</example>
<para>
@ -2426,7 +2428,7 @@ example doesn't show descriptions for the items.
<example id="mmemuco"> <title> Milt Columnar Menus Example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/menus/menu_multi_column.c">
fileref="resources/ncurses_programs/menus/menu_multi_column.c">
</imageobject></inlinemediaobject></programlisting>
</example>
<para>
@ -2479,7 +2481,7 @@ brings us to the request REQ_TOGGLE_ITEM. Let's see it in action.
<example id="mmeto"><title> Multi Valued Menus example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/menus/menu_toggle.c">
fileref="resources/ncurses_programs/menus/menu_toggle.c">
</imageobject></inlinemediaobject></programlisting>
</example>
<para>
@ -2525,7 +2527,7 @@ this example
<example id="mmeat"><title> Menu Options example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/menus/menu_attrib.c">
fileref="resources/ncurses_programs/menus/menu_attrib.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -2542,7 +2544,7 @@ pressed &lt;ENTER&gt;);
<example id="mmeus"><title> Menu User Pointer Usage </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/menus/menu_userptr.c">
fileref="resources/ncurses_programs/menus/menu_userptr.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>
@ -2636,7 +2638,7 @@ in that order.
<example id="ffosi"><title> Forms Basics </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/forms/form_simple.c">
fileref="resources/ncurses_programs/forms/form_simple.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -2774,7 +2776,7 @@ display colored fields? Here's an example clarifying color attributes.
<example id="ffoat"> <title> Form Attributes example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/forms/form_attrib.c">
fileref="resources/ncurses_programs/forms/form_attrib.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -2943,7 +2945,7 @@ are explained where appropriate.
<example id="ffoop"> <title> Field Options Usage example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/forms/form_options.c">
fileref="resources/ncurses_programs/forms/form_options.c">
</imageobject></inlinemediaobject></programlisting>
</example>
@ -3141,7 +3143,7 @@ with out much explanation. The functions are similar and they work the same way.
<example id="ffowi"><title> Form Windows Example </title>
<programlisting><inlinemediaobject><imageobject>
<imagedata format="linespecific"
fileref="ncurses_programs/forms/form_win.c">
fileref="resources/ncurses_programs/forms/form_win.c">
</imageobject></inlinemediaobject></programlisting>
</example>
</sect2>