HTML Help Workshop support
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@2435 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -30,6 +30,12 @@
|
|||||||
|
|
||||||
extern void DecToHex(int, char *);
|
extern void DecToHex(int, char *);
|
||||||
void GenerateHTMLIndexFile(char *fname);
|
void GenerateHTMLIndexFile(char *fname);
|
||||||
|
|
||||||
|
void GenerateHTMLWorkshopFiles(char *fname);
|
||||||
|
void HTMLWorkshopAddToContents(int level, char *s, char *file);
|
||||||
|
void HTMLWorkshopStartContents();
|
||||||
|
void HTMLWorkshopEndContents();
|
||||||
|
|
||||||
void OutputContentsFrame(void);
|
void OutputContentsFrame(void);
|
||||||
|
|
||||||
#include "readshg.h" // Segmented hypergraphics parsing
|
#include "readshg.h" // Segmented hypergraphics parsing
|
||||||
@@ -650,6 +656,7 @@ void HTMLOnMacro(int macroId, int no_args, bool start)
|
|||||||
AddTexRef(topicName, ChaptersName, ChapterNameString);
|
AddTexRef(topicName, ChaptersName, ChapterNameString);
|
||||||
|
|
||||||
SetCurrentChapterName(topicName, ChaptersName);
|
SetCurrentChapterName(topicName, ChaptersName);
|
||||||
|
if (htmlWorkshopFiles) HTMLWorkshopAddToContents(0, topicName, ChaptersName);
|
||||||
|
|
||||||
SetCurrentOutput(Chapters);
|
SetCurrentOutput(Chapters);
|
||||||
|
|
||||||
@@ -719,6 +726,7 @@ void HTMLOnMacro(int macroId, int no_args, bool start)
|
|||||||
AddTexRef(topicName, SectionsName, SectionNameString);
|
AddTexRef(topicName, SectionsName, SectionNameString);
|
||||||
|
|
||||||
SetCurrentSectionName(topicName, SectionsName);
|
SetCurrentSectionName(topicName, SectionsName);
|
||||||
|
if (htmlWorkshopFiles) HTMLWorkshopAddToContents(1, topicName, SectionsName);
|
||||||
|
|
||||||
SetCurrentOutput(Sections);
|
SetCurrentOutput(Sections);
|
||||||
TexOutput("<head><title>");
|
TexOutput("<head><title>");
|
||||||
@@ -811,6 +819,7 @@ void HTMLOnMacro(int macroId, int no_args, bool start)
|
|||||||
ReopenFile(&Subsections, &SubsectionsName);
|
ReopenFile(&Subsections, &SubsectionsName);
|
||||||
AddTexRef(topicName, SubsectionsName, SubsectionNameString);
|
AddTexRef(topicName, SubsectionsName, SubsectionNameString);
|
||||||
SetCurrentSubsectionName(topicName, SubsectionsName);
|
SetCurrentSubsectionName(topicName, SubsectionsName);
|
||||||
|
if (htmlWorkshopFiles) HTMLWorkshopAddToContents(2, topicName, SubsectionsName);
|
||||||
SetCurrentOutput(Subsections);
|
SetCurrentOutput(Subsections);
|
||||||
|
|
||||||
TexOutput("<head><title>");
|
TexOutput("<head><title>");
|
||||||
@@ -837,6 +846,7 @@ void HTMLOnMacro(int macroId, int no_args, bool start)
|
|||||||
{
|
{
|
||||||
AddTexRef(topicName, SectionsName, SubsectionNameString);
|
AddTexRef(topicName, SectionsName, SubsectionNameString);
|
||||||
SetCurrentSubsectionName(topicName, SectionsName);
|
SetCurrentSubsectionName(topicName, SectionsName);
|
||||||
|
|
||||||
// if ( subsectionNo != 0 )
|
// if ( subsectionNo != 0 )
|
||||||
fprintf(Sections, "\n<HR>\n");
|
fprintf(Sections, "\n<HR>\n");
|
||||||
|
|
||||||
@@ -851,6 +861,7 @@ void HTMLOnMacro(int macroId, int no_args, bool start)
|
|||||||
OutputCurrentSection();
|
OutputCurrentSection();
|
||||||
TexOutput("</A><BR>\n");
|
TexOutput("</A><BR>\n");
|
||||||
|
|
||||||
|
if (htmlWorkshopFiles) HTMLWorkshopAddToContents(2, topicName, SectionsName);
|
||||||
SetCurrentOutput(Sections);
|
SetCurrentOutput(Sections);
|
||||||
}
|
}
|
||||||
// Add this section title to the list of keywords
|
// Add this section title to the list of keywords
|
||||||
@@ -888,6 +899,7 @@ void HTMLOnMacro(int macroId, int no_args, bool start)
|
|||||||
ReopenFile(&Subsubsections, &SubsubsectionsName);
|
ReopenFile(&Subsubsections, &SubsubsectionsName);
|
||||||
AddTexRef(topicName, SubsubsectionsName, SubsubsectionNameString);
|
AddTexRef(topicName, SubsubsectionsName, SubsubsectionNameString);
|
||||||
SetCurrentSubsubsectionName(topicName, SubsubsectionsName);
|
SetCurrentSubsubsectionName(topicName, SubsubsectionsName);
|
||||||
|
if (htmlWorkshopFiles) HTMLWorkshopAddToContents(3, topicName, SubsubsectionsName);
|
||||||
|
|
||||||
SetCurrentOutput(Subsubsections);
|
SetCurrentOutput(Subsubsections);
|
||||||
TexOutput("<head><title>");
|
TexOutput("<head><title>");
|
||||||
@@ -926,6 +938,7 @@ void HTMLOnMacro(int macroId, int no_args, bool start)
|
|||||||
OutputCurrentSection();
|
OutputCurrentSection();
|
||||||
TexOutput("</A><BR>");
|
TexOutput("</A><BR>");
|
||||||
*/
|
*/
|
||||||
|
if (htmlWorkshopFiles) HTMLWorkshopAddToContents(2, topicName, SectionsName);
|
||||||
SetCurrentOutput(Sections);
|
SetCurrentOutput(Sections);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -1920,6 +1933,23 @@ bool HTMLOnArgument(int macroId, int arg_no, bool start)
|
|||||||
strcat(buf, ".gif");
|
strcat(buf, ".gif");
|
||||||
f = TexPathList.FindValidPath(buf);
|
f = TexPathList.FindValidPath(buf);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (f == "") // Try for a JPEG instead
|
||||||
|
{
|
||||||
|
strcpy(buf, filename);
|
||||||
|
StripExtension(buf);
|
||||||
|
strcat(buf, ".jpg");
|
||||||
|
f = TexPathList.FindValidPath(buf);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (f == "") // Try for a PNG instead
|
||||||
|
{
|
||||||
|
strcpy(buf, filename);
|
||||||
|
StripExtension(buf);
|
||||||
|
strcat(buf, ".png");
|
||||||
|
f = TexPathList.FindValidPath(buf);
|
||||||
|
}
|
||||||
|
|
||||||
if (f != "")
|
if (f != "")
|
||||||
{
|
{
|
||||||
char *inlineFilename = copystring(f);
|
char *inlineFilename = copystring(f);
|
||||||
@@ -2800,6 +2830,7 @@ bool HTMLGo(void)
|
|||||||
fprintf(Contents, "<UL>\n");
|
fprintf(Contents, "<UL>\n");
|
||||||
|
|
||||||
SetCurrentOutput(Titlepage);
|
SetCurrentOutput(Titlepage);
|
||||||
|
if (htmlWorkshopFiles) HTMLWorkshopStartContents();
|
||||||
OnInform("Converting...");
|
OnInform("Converting...");
|
||||||
|
|
||||||
TraverseDocument();
|
TraverseDocument();
|
||||||
@@ -2949,8 +2980,17 @@ bool HTMLGo(void)
|
|||||||
GenerateHTMLIndexFile(htmlIndexName);
|
GenerateHTMLIndexFile(htmlIndexName);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Generate HTML Help Workshop files if requested
|
||||||
|
if (htmlWorkshopFiles)
|
||||||
|
{
|
||||||
|
HTMLWorkshopEndContents();
|
||||||
|
GenerateHTMLWorkshopFiles(FileRoot);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
return TRUE;
|
return TRUE;
|
||||||
}
|
}
|
||||||
|
|
||||||
return FALSE;
|
return FALSE;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -2980,3 +3020,152 @@ void GenerateHTMLIndexFile(char *fname)
|
|||||||
}
|
}
|
||||||
fclose(fd);
|
fclose(fd);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
// output .hpp, .hhc and .hhk files:
|
||||||
|
|
||||||
|
|
||||||
|
void GenerateHTMLWorkshopFiles(char *fname)
|
||||||
|
{
|
||||||
|
FILE *f;
|
||||||
|
char buf[300];
|
||||||
|
|
||||||
|
/* Generate project file : */
|
||||||
|
|
||||||
|
sprintf(buf, "%s.hhp", fname);
|
||||||
|
f = fopen(buf, "wt");
|
||||||
|
fprintf(f,
|
||||||
|
"[OPTIONS]\n"
|
||||||
|
"Compatibility=1.1 or later\n"
|
||||||
|
"Contents file=%s.hhc\n"
|
||||||
|
"Default topic=%s\n"
|
||||||
|
"Index file=%s.hhk\n"
|
||||||
|
"Title=",
|
||||||
|
FileNameFromPath(fname),
|
||||||
|
FileNameFromPath(TitlepageName),
|
||||||
|
FileNameFromPath(fname)
|
||||||
|
);
|
||||||
|
|
||||||
|
if (DocumentTitle) {
|
||||||
|
SetCurrentOutput(f);
|
||||||
|
TraverseChildrenFromChunk(DocumentTitle);
|
||||||
|
}
|
||||||
|
else fprintf(f, "(unknown)");
|
||||||
|
|
||||||
|
fprintf(f, "\n\n[FILES]\n");
|
||||||
|
fprintf(f, "%s\n", FileNameFromPath(TitlepageName));
|
||||||
|
for (int i = 1; i <= fileId; i++) {
|
||||||
|
if (truncateFilenames)
|
||||||
|
sprintf(buf, "%s%d.htm", FileNameFromPath(FileRoot), i);
|
||||||
|
else
|
||||||
|
sprintf(buf, "%s%d.html", FileNameFromPath(FileRoot), i);
|
||||||
|
fprintf(f, "%s\n", buf);
|
||||||
|
}
|
||||||
|
fclose(f);
|
||||||
|
|
||||||
|
/* Generate index file : */
|
||||||
|
|
||||||
|
sprintf(buf, "%s.hhk", fname);
|
||||||
|
f = fopen(buf, "wt");
|
||||||
|
|
||||||
|
fprintf(f,
|
||||||
|
"<!DOCTYPE HTML PUBLIC \"-//IETF//DTD HTML//EN\">\n"
|
||||||
|
"<HTML>\n"
|
||||||
|
"<HEAD>\n"
|
||||||
|
"<meta name=\"GENERATOR\" content=\"tex2rtf\">\n"
|
||||||
|
"<!-- Sitemap 1.0 -->\n"
|
||||||
|
"</HEAD><BODY>\n"
|
||||||
|
"<OBJECT type=\"text/site properties\">\n"
|
||||||
|
" <param name=\"ImageType\" value=\"Folder\">\n"
|
||||||
|
"</OBJECT>\n"
|
||||||
|
"<UL>\n");
|
||||||
|
|
||||||
|
TopicTable.BeginFind();
|
||||||
|
wxNode *node = NULL;
|
||||||
|
while ((node = TopicTable.Next()))
|
||||||
|
{
|
||||||
|
TexTopic *texTopic = (TexTopic *)node->Data();
|
||||||
|
const char *topicName = node->GetKeyString();
|
||||||
|
if (texTopic->filename && texTopic->keywords)
|
||||||
|
{
|
||||||
|
wxNode *node1 = texTopic->keywords->First();
|
||||||
|
while (node1)
|
||||||
|
{
|
||||||
|
char *s = (char *)node1->Data();
|
||||||
|
fprintf(f,
|
||||||
|
" <LI> <OBJECT type=\"text/sitemap\">\n"
|
||||||
|
" <param name=\"Local\" value=\"%s#%s\">\n"
|
||||||
|
" <param name=\"Name\" value=\"%s\">\n"
|
||||||
|
" </OBJECT>\n",
|
||||||
|
texTopic->filename, topicName, s);
|
||||||
|
node1 = node1->Next();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fprintf(f, "</UL>\n");
|
||||||
|
fclose(f);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
static FILE *HTMLWorkshopContents = NULL;
|
||||||
|
static int HTMLWorkshopLastLevel = 0;
|
||||||
|
|
||||||
|
void HTMLWorkshopAddToContents(int level, char *s, char *file)
|
||||||
|
{
|
||||||
|
int i;
|
||||||
|
|
||||||
|
if (level > HTMLWorkshopLastLevel)
|
||||||
|
for (i = HTMLWorkshopLastLevel; i < level; i++)
|
||||||
|
fprintf(HTMLWorkshopContents, "<UL>");
|
||||||
|
if (level < HTMLWorkshopLastLevel)
|
||||||
|
for (i = level; i < HTMLWorkshopLastLevel; i++)
|
||||||
|
fprintf(HTMLWorkshopContents, "</UL>");
|
||||||
|
|
||||||
|
SetCurrentOutput(HTMLWorkshopContents);
|
||||||
|
fprintf(HTMLWorkshopContents,
|
||||||
|
" <LI> <OBJECT type=\"text/sitemap\">\n"
|
||||||
|
" <param name=\"Local\" value=\"%s#%s\">\n"
|
||||||
|
" <param name=\"Name\" value=\"",
|
||||||
|
file, s);
|
||||||
|
OutputCurrentSection();
|
||||||
|
fprintf(HTMLWorkshopContents,
|
||||||
|
"\">\n"
|
||||||
|
" </OBJECT>\n");
|
||||||
|
HTMLWorkshopLastLevel = level;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void HTMLWorkshopStartContents()
|
||||||
|
{
|
||||||
|
char buf[300];
|
||||||
|
sprintf(buf, "%s.hhc", FileRoot);
|
||||||
|
HTMLWorkshopContents = fopen(buf, "wt");
|
||||||
|
HTMLWorkshopLastLevel = 0;
|
||||||
|
|
||||||
|
fprintf(HTMLWorkshopContents,
|
||||||
|
"<!DOCTYPE HTML PUBLIC \"-//IETF//DTD HTML//EN\">\n"
|
||||||
|
"<HTML>\n"
|
||||||
|
"<HEAD>\n"
|
||||||
|
"<meta name=\"GENERATOR\" content=\"tex2rtf\">\n"
|
||||||
|
"<!-- Sitemap 1.0 -->\n"
|
||||||
|
"</HEAD><BODY>\n"
|
||||||
|
"<OBJECT type=\"text/site properties\">\n"
|
||||||
|
" <param name=\"ImageType\" value=\"Folder\">\n"
|
||||||
|
"</OBJECT>\n"
|
||||||
|
"<UL>\n");
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
void HTMLWorkshopEndContents()
|
||||||
|
{
|
||||||
|
for (int i = HTMLWorkshopLastLevel; i >= 0; i--)
|
||||||
|
fprintf(HTMLWorkshopContents, "</UL>\n");
|
||||||
|
fclose(HTMLWorkshopContents);
|
||||||
|
}
|
||||||
|
@@ -121,6 +121,7 @@ char *textColourString = NULL;
|
|||||||
char *linkColourString = NULL;
|
char *linkColourString = NULL;
|
||||||
char *followedLinkColourString = NULL;
|
char *followedLinkColourString = NULL;
|
||||||
bool combineSubSections = FALSE;
|
bool combineSubSections = FALSE;
|
||||||
|
bool htmlWorkshopFiles = FALSE;
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* International support
|
* International support
|
||||||
|
@@ -238,6 +238,7 @@ extern char *textColourString; // HTML text colour
|
|||||||
extern char *linkColourString; // HTML link colour
|
extern char *linkColourString; // HTML link colour
|
||||||
extern char *followedLinkColourString; // HTML followed link colour
|
extern char *followedLinkColourString; // HTML followed link colour
|
||||||
extern bool combineSubSections; // Stop splitting files below section
|
extern bool combineSubSections; // Stop splitting files below section
|
||||||
|
extern bool htmlWorkshopFiles; // generate HTML Help Workshop project files
|
||||||
|
|
||||||
// Names to help with internationalisation
|
// Names to help with internationalisation
|
||||||
extern char *ContentsNameString;
|
extern char *ContentsNameString;
|
||||||
|
@@ -1166,6 +1166,8 @@ char *RegisterSetting(char *settingName, char *settingValue, bool interactive)
|
|||||||
winHelpContents = StringTobool(settingValue);
|
winHelpContents = StringTobool(settingValue);
|
||||||
else if (StringMatch(settingName, "htmlIndex", FALSE, TRUE))
|
else if (StringMatch(settingName, "htmlIndex", FALSE, TRUE))
|
||||||
htmlIndex = StringTobool(settingValue);
|
htmlIndex = StringTobool(settingValue);
|
||||||
|
else if (StringMatch(settingName, "htmlWorkshopFiles", FALSE, TRUE))
|
||||||
|
htmlWorkshopFiles = StringTobool(settingValue);
|
||||||
else if (StringMatch(settingName, "htmlFrameContents", FALSE, TRUE))
|
else if (StringMatch(settingName, "htmlFrameContents", FALSE, TRUE))
|
||||||
htmlFrameContents = StringTobool(settingValue);
|
htmlFrameContents = StringTobool(settingValue);
|
||||||
else if (StringMatch(settingName, "upperCaseNames", FALSE, TRUE))
|
else if (StringMatch(settingName, "upperCaseNames", FALSE, TRUE))
|
||||||
|
Reference in New Issue
Block a user