2a2d1764dc
* contrib\gtwvg\wvg3stat.prg
* contrib\gtwvg\wvgax.prg
* contrib\gtwvg\wvgcheck.prg
* contrib\gtwvg\wvgclass.prg
* contrib\gtwvg\wvgcombo.prg
* contrib\gtwvg\wvgcrt.prg
* contrib\gtwvg\wvgdarea.prg
* contrib\gtwvg\wvgdatar.prg
* contrib\gtwvg\wvgdlg.prg
* contrib\gtwvg\wvggenrc.prg
* contrib\gtwvg\wvghtmlv.prg
* contrib\gtwvg\wvglistb.prg
* contrib\gtwvg\wvgmenub.prg
* contrib\gtwvg\wvgmle.prg
* contrib\gtwvg\wvgpaint.prg
* contrib\gtwvg\wvgphdlr.prg
* contrib\gtwvg\wvgpushb.prg
* contrib\gtwvg\wvgradio.prg
* contrib\gtwvg\wvgscrlb.prg
* contrib\gtwvg\wvgsle.prg
* contrib\gtwvg\wvgstatb.prg
* contrib\gtwvg\wvgstatc.prg
* contrib\gtwvg\wvgsysw.prg
* contrib\gtwvg\wvgtabpg.prg
* contrib\gtwvg\wvgtoolb.prg
* contrib\gtwvg\wvgtreev.prg
* contrib\gtwvg\wvgwnd.prg
* contrib\hbblat\blatcls.prg
* contrib\hbblink\blinker.prg
* contrib\hbcomm\comm.prg
* contrib\hbct\ctmisc.prg
* contrib\hbct\ctrand.prg
* contrib\hbct\cttime.prg
* contrib\hbct\fcopy.prg
* contrib\hbct\getinfo.prg
* contrib\hbct\getinput.prg
* contrib\hbct\getsecrt.prg
* contrib\hbct\keysec.prg
* contrib\hbct\keytime.prg
* contrib\hbct\kxlat.prg
* contrib\hbct\screen3.prg
* contrib\hbct\scrmark.prg
* contrib\hbct\showtime.prg
* contrib\hbct\tempfile.prg
* contrib\hbfbird\tests\test.prg
* contrib\hbfbird\tfirebrd.prg
* contrib\hbgd\gd.prg
* contrib\hbgd\gdbar.prg
* contrib\hbgd\gdbarcod.prg
* contrib\hbgd\gdchart.prg
* contrib\hbmisc\calldll.prg
* contrib\hbmisc\hbedit.prg
* contrib\hbmisc\udpds.prg
* contrib\hbmysql\tmysql.prg
* contrib\hbmysql\tsqlbrw.prg
* contrib\hbodbc\browodbc.prg
* contrib\hbodbc\todbc.prg
* contrib\hbpgsql\tpostgre.prg
* contrib\hbqt\qtcore\hbqt_misc.prg
* contrib\hbrun\hbrun.prg
* contrib\hbsms\sms.prg
* contrib\hbsqlit3\hdbcsqlt.prg
* contrib\hbtip\cgi.prg
* contrib\hbtip\client.prg
* contrib\hbtip\encb64.prg
* contrib\hbtip\encoder.prg
* contrib\hbtip\ftpcli.prg
* contrib\hbtip\httpcli.prg
* contrib\hbtip\log.prg
* contrib\hbtip\mail.prg
* contrib\hbtip\popcli.prg
* contrib\hbtip\sendmail.prg
* contrib\hbtip\smtpcli.prg
* contrib\hbtip\thtml.prg
* contrib\hbtip\url.prg
* contrib\hbtpathy\telepath.prg
* contrib\hbwin\tests\testprn.prg
* contrib\hbwin\wce_sim.prg
* contrib\hbwin\win_os.prg
* contrib\hbwin\win_reg.prg
* contrib\hbwin\win_tbmp.prg
* contrib\hbwin\win_tprn.prg
* contrib\hbxbp\hbpprocess.prg
* contrib\hbxbp\xbp3state.prg
* contrib\hbxbp\xbpbrowse.prg
* contrib\hbxbp\xbpcheckbox.prg
* contrib\hbxbp\xbpcombobox.prg
* contrib\hbxbp\xbpcrt.prg
* contrib\hbxbp\xbpdataref.prg
* contrib\hbxbp\xbpdialog.prg
* contrib\hbxbp\xbpfiledialog.prg
* contrib\hbxbp\xbpfontdialog.prg
* contrib\hbxbp\xbpgeneric.prg
* contrib\hbxbp\xbpgra.prg
* contrib\hbxbp\xbphtmlviewer.prg
* contrib\hbxbp\xbplistbox.prg
* contrib\hbxbp\xbpmenubar.prg
* contrib\hbxbp\xbpmle.prg
* contrib\hbxbp\xbpparthandler.prg
* contrib\hbxbp\xbppresspace.prg
* contrib\hbxbp\xbpprintdialog.prg
* contrib\hbxbp\xbpprinter.prg
* contrib\hbxbp\xbppushbutton.prg
* contrib\hbxbp\xbpradiobutton.prg
* contrib\hbxbp\xbprtf.prg
* contrib\hbxbp\xbpscrollbar.prg
* contrib\hbxbp\xbpsle.prg
* contrib\hbxbp\xbpspinbutton.prg
* contrib\hbxbp\xbpstatic.prg
* contrib\hbxbp\xbpstatusbar.prg
* contrib\hbxbp\xbpstyle.prg
* contrib\hbxbp\xbptabpage.prg
* contrib\hbxbp\xbptoolbar.prg
* contrib\hbxbp\xbptreeview.prg
* contrib\hbxbp\xbpwindow.prg
* contrib\hbxpp\dbfuncsx.prg
* contrib\hbxpp\runshell.prg
* contrib\hbxpp\thfuncx.prg
* contrib\hbxpp\tthreadx.prg
* contrib\xhb\cstruct.prg
* contrib\xhb\dbgfx.prg
* contrib\xhb\dirrec.prg
* contrib\xhb\dumpvar.prg
* contrib\xhb\hbcomprs.prg
* contrib\xhb\hblog.prg
* contrib\xhb\hjwindow.prg
* contrib\xhb\hterrsys.prg
* contrib\xhb\htmutil.prg
* contrib\xhb\sprintf.prg
* contrib\xhb\tedit.prg
* contrib\xhb\tframe.prg
* contrib\xhb\thtm.prg
* contrib\xhb\trpc.prg
* contrib\xhb\trpccli.prg
* contrib\xhb\ttable.prg
* contrib\xhb\xcstr.prg
* contrib\xhb\xdbmodst.prg
* contrib\xhb\xhberr.prg
* contrib\xhb\xhbmemo.prg
* contrib\xhb\xhbmt.prg
* contrib\xhb\xhbtedit.prg
* contrib\xhb\xhbver.prg
* examples\guestbk\inifiles.prg
* examples\hbdoc2\genhtml.prg
* examples\hbdoc2\hbdoc2.prg
* examples\hbvpdf\hbvpdf.prg
* examples\hbvpdf\hbvpdft.prg
* examples\httpsrv\uhttpd.prg
* examples\rddado\adordd.prg
* IS*() macros converted to HB_IS*() function calls.
(using full uppercase to make them stand out)
% deleted '#include "common.ch"' where possible
311 lines
11 KiB
Plaintext
311 lines
11 KiB
Plaintext
/*
|
|
* $Id$
|
|
*/
|
|
|
|
/*
|
|
* Harbour Project source code:
|
|
* Document generator - HTML output
|
|
*
|
|
* Copyright 2009 April White <april users.sourceforge.net>
|
|
* www - http://harbour-project.org
|
|
*
|
|
* Portions of this project are based on hbdoc
|
|
* Copyright 1999-2003 Luiz Rafael Culik <culikr@uol.com.br>
|
|
* Copyright 2000 Luiz Rafael Culik <culik@sl.conex.net>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2, or (at your option)
|
|
* any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this software; see the file COPYING. If not, write to
|
|
* the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
|
|
* Boston, MA 02111-1307 USA (or visit the web site http://www.gnu.org/).
|
|
*
|
|
* As a special exception, the Harbour Project gives permission for
|
|
* additional uses of the text contained in its release of Harbour.
|
|
*
|
|
* The exception is that, if you link the Harbour libraries with other
|
|
* files to produce an executable, this does not by itself cause the
|
|
* resulting executable to be covered by the GNU General Public License.
|
|
* Your use of that executable is in no way restricted on account of
|
|
* linking the Harbour library code into it.
|
|
*
|
|
* This exception does not however invalidate any other reasons why
|
|
* the executable file might be covered by the GNU General Public License.
|
|
*
|
|
* This exception applies only to the code released by the Harbour
|
|
* Project under the name Harbour. If you copy code from other
|
|
* Harbour Project or Free Software Foundation releases into a copy of
|
|
* Harbour, as the General Public License permits, the exception does
|
|
* not apply to the code that you add in this way. To avoid misleading
|
|
* anyone as to the status of such modified files, you must delete
|
|
* this exception notice from them.
|
|
*
|
|
* If you write modifications of your own for Harbour, it is your choice
|
|
* whether to permit this exception to apply to your modifications.
|
|
* If you do not wish that, delete this exception notice.
|
|
*
|
|
*/
|
|
|
|
#include "hbclass.ch"
|
|
#include "common.ch"
|
|
#include "inkey.ch"
|
|
#include "fileio.ch"
|
|
#include "hbdoc2.ch"
|
|
|
|
#ifdef __PLATFORM__DOS
|
|
#define EXTENSION ".htm"
|
|
#else
|
|
#define EXTENSION ".html"
|
|
#endif
|
|
|
|
CLASS GenerateHTML2 FROM GenerateHTML
|
|
METHOD NewIndex( cFolder, cFilename, cTitle )
|
|
METHOD NewDocument( cFolder, cFilename, cTitle )
|
|
ENDCLASS
|
|
|
|
METHOD NewDocument( cFolder, cFilename, cTitle ) CLASS GenerateHTML2
|
|
super:NewDocument( cFolder, cFilename, cTitle, EXTENSION )
|
|
RETURN self
|
|
|
|
METHOD NewIndex( cFolder, cFilename, cTitle ) CLASS GenerateHTML2
|
|
super:NewIndex( cFolder, cFilename, cTitle, EXTENSION )
|
|
RETURN self
|
|
|
|
CLASS GenerateHTML FROM TPLGenerate
|
|
HIDDEN:
|
|
METHOD RecreateStyleDocument( cStyleFile )
|
|
METHOD OpenTag( cText, ... )
|
|
METHOD Tagged( cText, cTag, ... )
|
|
METHOD CloseTag( cText )
|
|
METHOD Append( cText, cFormat )
|
|
METHOD Newline() INLINE FWrite( ::nHandle, "<br />" + hb_eol() ), self
|
|
|
|
CLASSDATA lCreateStyleDocument AS LOGICAL INIT .T.
|
|
DATA TargetFilename AS STRING INIT ""
|
|
|
|
EXPORTED:
|
|
METHOD NewFile() HIDDEN
|
|
METHOD NewIndex( cFolder, cFilename, cTitle )
|
|
METHOD NewDocument( cFolder, cFilename, cTitle )
|
|
METHOD AddEntry( oEntry )
|
|
METHOD AddReference( oEntry, cReference, cSubReference )
|
|
METHOD BeginSection( cSection, cFilename )
|
|
METHOD EndSection( cSection, cFilename )
|
|
METHOD Generate()
|
|
|
|
METHOD WriteEntry( cField, oEntry, lPreformatted, nIndent ) HIDDEN
|
|
ENDCLASS
|
|
|
|
METHOD NewFile() CLASS GenerateHTML
|
|
FWrite( ::nHandle, '<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">' + hb_eol() )
|
|
|
|
::OpenTag( "html" )
|
|
::OpenTag( "head" )
|
|
|
|
::Append( ::cTitle /* + IIf( Empty( ::cDescription ), "", " - " + ::cDescription ) */, "title" )
|
|
::OpenTag( "meta", "name", "generator", "content", "Harbour examples/hbdoc2" )
|
|
::OpenTag( "meta", "name", "keywords", "content", "Harbour project, Clipper, xBase, database, Free Software, GNU, compiler, cross platform, 32-bit, FiveWin" )
|
|
|
|
#define STYLEFILE "hrb_doc.css"
|
|
IF ::lCreateStyleDocument
|
|
::lCreateStyleDocument := .F.
|
|
::RecreateStyleDocument( STYLEFILE )
|
|
ENDIF
|
|
::OpenTag( "link", "rel", "stylesheet", "type", "text/css", "href", STYLEFILE )
|
|
#undef STYLEFILE
|
|
|
|
::CloseTag( "head" )
|
|
::OpenTag( "body" )
|
|
::Append( ::cTitle, "h1" )
|
|
|
|
RETURN self
|
|
|
|
METHOD NewDocument( cFolder, cFilename, cTitle ) CLASS GenerateHTML
|
|
super:NewDocument( cFolder, cFilename, cTitle, EXTENSION )
|
|
::NewFile()
|
|
RETURN self
|
|
|
|
METHOD NewIndex( cFolder, cFilename, cTitle ) CLASS GenerateHTML
|
|
super:NewIndex( cFolder, cFilename, cTitle, EXTENSION )
|
|
::NewFile()
|
|
RETURN self
|
|
|
|
METHOD BeginSection( cSection, cFilename ) CLASS GenerateHTML
|
|
IF ::IsIndex()
|
|
If cFilename == ::cFilename
|
|
::OpenTag( "a", "name", cSection ):Append( cSection, "h" + HB_NTOS( ::Depth + 2 ) ):CloseTag( "a" )//:Newline()
|
|
ELSE
|
|
::OpenTag( "a", "href", cFilename + ::cExtension + "#" + cSection ):Append( cSection, "h" + HB_NTOS( ::Depth + 2 ) ):CloseTag( "a" )//:Newline()
|
|
ENDIF
|
|
ELSE
|
|
::OpenTag( "a", "name", cSection ):Append( cSection, "h" + HB_NTOS( ::Depth + 2 ) ):CloseTag( "a" )//:Newline()
|
|
ENDIF
|
|
::TargetFilename := cFilename
|
|
::Depth++
|
|
RETURN self
|
|
|
|
METHOD EndSection( cSection, cFilename ) CLASS GenerateHTML
|
|
HB_SYMBOL_UNUSED( cSection )
|
|
HB_SYMBOL_UNUSED( cFilename )
|
|
::Depth--
|
|
RETURN self
|
|
|
|
METHOD AddReference( oEntry, cReference, cSubReference ) CLASS GenerateHTML
|
|
IF HB_ISOBJECT( oEntry ) .AND. oEntry:ClassName == "ENTRY"
|
|
::OpenTag( "a", "href", ::TargetFilename + ::cExtension + "#" + oEntry:Filename ):Append( oEntry:Name ):CloseTag( "a" ):Append( oEntry:OneLiner ):Newline()
|
|
ELSE
|
|
IF cSubReference == NIL
|
|
::OpenTag( "a", "href", cReference + ::cExtension /* + "#" + oEntry:Filename */ ):Append( oEntry ):CloseTag( "a" ):Newline()
|
|
ELSE
|
|
::OpenTag( "a", "href", cReference + ::cExtension + "#" + cSubReference ):Append( oEntry ):CloseTag( "a" ):Newline()
|
|
ENDIF
|
|
ENDIF
|
|
RETURN self
|
|
|
|
METHOD AddEntry( oEntry ) CLASS GenerateHTML
|
|
LOCAL idx
|
|
|
|
FOR idx := 1 TO Len( oEntry:Fields )
|
|
IF oEntry:Fields[ idx ][ 1 ] == "NAME"
|
|
::OpenTag( "a", "name", oEntry:filename ):OpenTag( "h4" ):Append( oEntry:Name ):CloseTag( "h4" ):CloseTag( "a" )
|
|
ELSEIF oEntry:IsField( oEntry:Fields[ idx ][ 1 ] ) .AND. oEntry:IsOutput( oEntry:Fields[ idx ][ 1 ] ) .AND. Len( oEntry:&( oEntry:Fields[ idx ][ 1 ] ) ) > 0
|
|
::WriteEntry( oEntry:Fields[ idx ][ 1 ], oEntry, oEntry:IsPreformatted( oEntry:Fields[ idx ][ 1 ] ) )
|
|
ENDIF
|
|
NEXT
|
|
|
|
RETURN self
|
|
|
|
METHOD Generate() CLASS GenerateHTML
|
|
IF ! Empty( ::nHandle )
|
|
::CloseTag( "body" )
|
|
::CloseTag( "html" )
|
|
FClose( ::nHandle )
|
|
::nHandle := 0
|
|
ENDIF
|
|
RETURN self
|
|
|
|
METHOD PROCEDURE WriteEntry( cField, oEntry, lPreformatted, nIndent ) CLASS GenerateHTML
|
|
LOCAL cCaption := oEntry:FieldName( cField )
|
|
LOCAL cEntry := oEntry:&( cField )
|
|
// TODO: change this to search the CSS document itself
|
|
LOCAL cTagClass := IIf( LOWER( cField ) + "|" $ "name|oneliner|examples|tests|", LOWER( cField ), "itemtext" )
|
|
|
|
IF ! Empty( cEntry )
|
|
DEFAULT cCaption TO ""
|
|
DEFAULT nIndent TO 0
|
|
//~ DEFAULT lPreformatted TO .F.
|
|
//~ DEFAULT cTagClass TO "itemtext"
|
|
|
|
IF Len( cCaption ) > 0 /* .AND. nIndent > 0 */
|
|
::Tagged( cCaption, "div", "class", "itemtitle" )
|
|
ENDIF
|
|
|
|
IF lPreformatted
|
|
::OpenTag( "pre", IIf( cTagClass != NIL, "class", ), cTagClass )
|
|
DO WHILE Len( cEntry ) > 0
|
|
::Append( Indent( Parse( @cEntry, hb_eol() ), 0, , .T. ), "" )
|
|
//~ IF Len( cEntry ) > 0 .AND. ! lPreformatted
|
|
//~ FWrite( ::nHandle, hb_eol() )
|
|
//~ ENDIF
|
|
ENDDO
|
|
::CloseTag( "pre" )
|
|
ELSE
|
|
DO WHILE Len( cEntry ) > 0
|
|
::OpenTag( "div", "class", cTagClass )
|
|
::Append( Indent( Parse( @cEntry, hb_eol() ), 0, 70 ), "" ):Newline()
|
|
::CloseTag( "div" )
|
|
ENDDO
|
|
ENDIF
|
|
ENDIF
|
|
|
|
METHOD OpenTag( cText, ... ) CLASS GenerateHTML
|
|
LOCAL aArgs := HB_AParams()
|
|
LOCAL cTag := cText
|
|
LOCAL idx
|
|
|
|
FOR idx := 2 TO Len( aArgs ) STEP 2
|
|
cTag += " " + aArgs[ idx ] + "=" + Chr(34) + aArgs[ idx + 1 ] + Chr(34)
|
|
NEXT
|
|
|
|
FWrite( ::nHandle, "<" + cTag + ">" + hb_eol() )
|
|
|
|
RETURN self
|
|
|
|
METHOD Tagged( cText, cTag, ... ) CLASS GenerateHTML
|
|
LOCAL aArgs := HB_AParams()
|
|
LOCAL cResult := "<" + cTag
|
|
LOCAL idx
|
|
|
|
FOR idx := 3 TO Len( aArgs ) STEP 2
|
|
cResult += " " + aArgs[ idx ] + "=" + Chr(34) + aArgs[ idx + 1 ] + Chr(34)
|
|
NEXT
|
|
|
|
FWrite( ::nHandle, cResult + ">" + cText + "</" + cTag + ">" + /* "4" + */ hb_eol() )
|
|
|
|
RETURN self
|
|
|
|
METHOD CloseTag( cText ) CLASS GenerateHTML
|
|
FWrite( ::nHandle, "</" + cText + ">" + hb_eol() )
|
|
|
|
IF cText == "html"
|
|
FClose( ::nHandle )
|
|
::nHandle := 0
|
|
ENDIF
|
|
|
|
RETURN self
|
|
|
|
METHOD Append( cText, cFormat ) CLASS GenerateHTML
|
|
LOCAL cResult := cText
|
|
LOCAL aFormat
|
|
LOCAL idx
|
|
|
|
IF Len( cResult ) > 0
|
|
|
|
DEFAULT cFormat TO ""
|
|
|
|
aFormat := p_aConversionList
|
|
FOR idx := 1 TO Len( aFormat ) STEP 2
|
|
cResult := StrTran( cResult, Chr( aFormat[ idx ] ), "&" + aFormat[ idx + 1 ] + ";" )
|
|
NEXT
|
|
|
|
aFormat := Split( cFormat, "," )
|
|
FOR idx := Len( aFormat ) TO 1 STEP -1
|
|
cResult := "<" + aFormat[ idx ] + ">" + cResult + "</" + aFormat[ idx ] + ">"
|
|
NEXT
|
|
|
|
DO WHILE Right( cResult, Len( hb_eol() ) ) == hb_eol()
|
|
cResult := SubStr( cResult, 1, Len( cResult ) - Len( hb_eol() ) )
|
|
ENDDO
|
|
|
|
FWrite( ::nHandle, cResult + hb_eol() )
|
|
|
|
ENDIF
|
|
|
|
RETURN self
|
|
|
|
METHOD RecreateStyleDocument( cStyleFile ) CLASS GenerateHTML
|
|
|
|
IF ! hb_MemoWrit( ::cFolder + hb_ps() + cStyleFile,;
|
|
"/* Harbour Documents Stylesheet (" + cStyleFile + ") */" + hb_eol() + ;
|
|
"body {font-family:arial;font-size:14px;line-height:18px;}" + hb_eol() + ;
|
|
/* ".classtitle {font-weight:bold;font-size:22px;padding-bottom:4px;}" + hb_eol() + */ ;
|
|
".name {font-weight:bold;font-size:18px;margin-left:0px;padding-top:0px;padding-bottom:4px;}" + hb_eol() + ;
|
|
".oneliner {font-style:italic;margin-bottom:12px;}" + hb_eol() + ;
|
|
".itemtitle {font-weight:bold;margin-left:0px;padding-top:0px;padding-bottom:4px;}" + hb_eol() + ;
|
|
".itemtext {margin-left:10px;padding-bottom:4px;}" + hb_eol() + ;
|
|
".examples {margin-left:10px;padding-bottom:4px;}" + hb_eol() + ;
|
|
".tests {margin-left:10px;padding-bottom:4px;}" + hb_eol() + ;
|
|
"" )
|
|
// TODO: raise an error, could not create style file
|
|
ENDIF
|
|
|
|
RETURN self
|