Class THTMLHelpDocGenerator
Unit
Declaration
type THTMLHelpDocGenerator = class(TGenericHTMLDocGenerator)
Description
This item has no description. Showing description inherited from TGenericHTMLDocGenerator.
HTML documentation generator. Extends TDocGenerator and overwrites many of its methods to generate output in HTML format.
Source: source/component/PasDoc_GenHtmlHelp.pas (line 33).
Hierarchy
- TObject
- TPersistent
- TComponent
- TDocGenerator
- TGenericHTMLDocGenerator
- THTMLHelpDocGenerator
Overview
Constants
| Public | DefaultAutoAbstract = true; |
Fields
| Protected | FLanguage: TPasDocLanguages; |
| Protected | FClassHierarchy: TStringCardinalTree; |
| Protected | FUnits: TPasUnits; |
Methods
| Protected | procedure DoError(const AMessage: string; const AArguments: array of const; const AExitCode: Word); |
| Protected | procedure DoMessage(const AVerbosity: Cardinal; const MessageType: TPasDocMessageType; const AMessage: string; const AArguments: array of const); |
| Protected | procedure CreateClassHierarchy; |
| Protected | procedure WriteCodeWithLinksCommon(const Item: TPasItem; const Code: string; WriteItemLink: boolean; const NameLinkBegin, NameLinkEnd: string); |
| Protected | function HasSourcePosition(const AItem: TPasItem; out ItemName, ItemFilenameInRoot, ItemUrl: string): boolean; |
| Protected | procedure CloseStream; |
| Protected | function CreateStream(const AName: string): Boolean; |
| Protected | function ExtractEmailAddress(s: string; out S1, S2, EmailAddress: string): Boolean; |
| Protected | function FixEmailaddressWithoutMailTo(const PossibleEmailAddress: String): String; |
| Protected | function ExtractWebAddress(s: string; out S1, S2, WebAddress: string): Boolean; |
| Protected | function FindGlobal(const NameParts: TNameParts): TBaseItem; |
| Protected | function FindGlobalPasItem(const NameParts: TNameParts): TPasItem; overload; |
| Protected | function FindGlobalPasItem(const ItemName: String): TPasItem; overload; |
| Protected | function GetClassDirectiveName(const Directive: TClassDirective): string; |
| Protected | function GetCIOTypeName(const MyType: TCIOType): string; |
| Protected | procedure LoadDescriptionFile(n: string); |
| Protected | function SearchItem(s: string; const Item: TBaseItem; WarningIfNotSplittable: boolean): TBaseItem; |
| Protected | function SearchLink(s: string; const Item: TBaseItem; const LinkDisplay: string; const WarningIfLinkNotFound: TLinkNotFoundAction; out FoundItem: TBaseItem): string; overload; |
| Protected | function SearchLink(s: string; const Item: TBaseItem; const LinkDisplay: string; const WarningIfLinkNotFound: TLinkNotFoundAction): string; overload; |
| Protected | procedure StoreDescription(ItemName: string; var t: string); |
| Protected | procedure WriteConverted(const s: string; Newline: boolean); overload; |
| Protected | procedure WriteConverted(const s: string); overload; |
| Protected | procedure WriteConvertedLine(const s: string); |
| Protected | procedure WriteDirect(const t: string; Newline: boolean); overload; |
| Protected | procedure WriteDirect(const t: string); overload; |
| Protected | procedure WriteDirectLine(const t: string); |
| Protected | procedure WriteUnits(const HL: integer); |
| Protected | procedure WriteGVUses; |
| Protected | procedure WriteGVClasses; |
| Protected | procedure StartSpellChecking(const AMode: string); |
| Protected | procedure CheckString(const AString: string; const AErrors: TSpellingErrorList); |
| Protected | procedure EndSpellChecking; |
| Protected | function FormatNormalCode(AString: string): string; virtual; |
| Protected | function ShortDash: string; virtual; |
| Protected | function LatexString(const S: string): string; virtual; |
| Protected | procedure WriteExternal(const ExternalItem: TExternalItem; const Id: TTranslationID); |
| Protected | procedure WriteConclusion; |
| Protected | procedure WriteIntroduction; |
| Protected | procedure WriteAdditionalFiles; |
| Public | procedure BuildLinks; |
| Public | procedure ResolveTypeAliasesDescriptions; |
| Public | procedure ExpandDescriptions; |
| Public | procedure LoadDescriptionFiles(const c: TStringVector); |
| Public | procedure ParseAbbreviationsFile(const AFileName: string); |
| Protected | function MakeBodyBegin: string; virtual; |
| Protected | function MakeBodyEnd: string; virtual; |
| Protected | function ConvertString(const s: string): string; override; |
| Protected | function ConvertChar(c: char): string; override; |
| Protected | procedure WriteUnit(const HL: integer; const U: TPasUnit); override; |
| Protected | function HtmlString(const S: string): string; override; |
| Protected | function FormatPascalCode(const Line: string): string; override; |
| Protected | function FormatComment(AString: string): string; override; |
| Protected | function FormatHex(AString: string): string; override; |
| Protected | function FormatNumeric(AString: string): string; override; |
| Protected | function FormatFloat(AString: string): string; override; |
| Protected | function FormatString(AString: string): string; override; |
| Protected | function FormatKeyWord(AString: string): string; override; |
| Protected | function FormatCompilerComment(AString: string): string; override; |
| Protected | function CodeString(const s: string): string; override; |
| Protected | function CreateLink(const Item: TBaseItem): string; override; |
| Protected | procedure WriteStartOfCode; override; |
| Protected | procedure WriteEndOfCode; override; |
| Protected | procedure WriteAnchor(const AName: string); overload; |
| Protected | procedure WriteAnchor(const AName, Caption: string); overload; |
| Protected | function Paragraph: string; override; |
| Protected | function EnDash: string; override; |
| Protected | function EmDash: string; override; |
| Protected | function LineBreak: string; override; |
| Protected | function URLLink(const URL: string): string; override; |
| Protected | function URLLink(const URL, LinkDisplay: string): string; override; |
| Protected | procedure WriteExternalCore(const ExternalItem: TExternalItem; const Id: TTranslationID); override; |
| Protected | function MakeItemLink(const Item: TBaseItem; const LinkCaption: string; const LinkContext: TLinkContext): string; override; |
| Protected | function EscapeURL(const AString: string): string; virtual; |
| Protected | function FormatSection(HL: integer; const Anchor: string; const Caption: string): string; override; |
| Protected | function FormatAnchor(const Anchor: string): string; override; |
| Protected | function FormatBold(const Text: string): string; override; |
| Protected | function FormatItalic(const Text: string): string; override; |
| Protected | function FormatWarning(const Text: string): string; override; |
| Protected | function FormatNote(const Text: string): string; override; |
| Protected | function FormatPreformatted(const Text: string): string; override; |
| Protected | function FormatImage(FileNames: TStringList): string; override; |
| Protected | function FormatList(ListData: TListData): string; override; |
| Protected | function FormatTable(Table: TTableData): string; override; |
| Protected | function FormatTableOfContents(Sections: TStringPairVector): string; override; |
| Public | constructor Create(AOwner: TComponent); override; |
| Public | destructor Destroy; override; |
| Public | function GetFileExtension: string; override; |
| Protected | function MakeHead: string; override; |
| Public | procedure WriteDocumentation; override; |
Properties
| Protected | property CurrentStream: TStream read FCurrentStream; |
| Public | property Units: TPasUnits read FUnits write FUnits; |
| Public | property Introduction: TExternalItem read FIntroduction
write FIntroduction; |
| Public | property Conclusion: TExternalItem read FConclusion write FConclusion; |
| Public | property AdditionalFiles: TExternalItemList read FAdditionalFiles write FAdditionalFiles; |
| Public | property OnMessage: TPasDocMessageEvent read FOnMessage write FOnMessage; |
| Published | property Language: TLanguageID read GetLanguage write SetLanguage
default DEFAULT_LANGUAGE; |
| Published | property ProjectName: string read FProjectName write FProjectName; |
| Published | property ExcludeGenerator: Boolean
read FExcludeGenerator write FExcludeGenerator default false; |
| Published | property IncludeCreationTime: Boolean
read FIncludeCreationTime write FIncludeCreationTime default false; |
| Published | property UseLowercaseKeywords: Boolean
read FUseLowercaseKeywords write FUseLowercaseKeywords default false; |
| Published | property Title: string read FTitle write FTitle; |
| Published | property DestinationDirectory: string read FDestDir write SetDestDir; |
| Published | property OutputGraphVizUses: boolean read FGraphVizUses write FGraphVizUses
default false; |
| Published | property OutputGraphVizClassHierarchy: boolean
read FGraphVizClasses write FGraphVizClasses default false; |
| Published | property LinkGraphVizUses: string read FLinkGraphVizUses write FLinkGraphVizUses; |
| Published | property LinkGraphVizClasses: string read FLinkGraphVizClasses write FLinkGraphVizClasses; |
| Published | property Abbreviations: TStringList read FAbbreviations write SetAbbreviations; |
| Published | property CheckSpelling: boolean read FCheckSpelling write FCheckSpelling
default false; |
| Published | property AspellLanguage: string read FAspellLanguage write FAspellLanguage; |
| Published | property SpellCheckIgnoreWords: TStringList
read FSpellCheckIgnoreWords write SetSpellCheckIgnoreWords; |
| Published | property AutoAbstract: boolean
read FAutoAbstract write FAutoAbstract default DefaultAutoAbstract; |
| Published | property LinkLook: TLinkLook read FLinkLook write FLinkLook default llDefault; |
| Published | property WriteUsesClause: boolean
read FWriteUsesClause write FWriteUsesClause default false; |
| Published | property AutoLink: boolean
read FAutoLink write FAutoLink default false; |
| Published | property AutoLinkExclude: TStringList read FAutoLinkExclude; |
| Published | property ExternalClassHierarchy: TStrings
read FExternalClassHierarchy write SetExternalClassHierarchy
stored StoredExternalClassHierarchy; |
| Published | property Markdown: boolean
read FMarkdown write FMarkdown default false; |
| Published | property ShowSourcePosition: boolean
read FShowSourcePosition write FShowSourcePosition default false; |
| Published | property SourceRoot: string
read FSourceRoot write FSourceRoot; |
| Published | property SourceUrlPattern: string
read FSourceUrlPattern write FSourceUrlPattern; |
| Published | property ToggleVisibilities: TVisibilities
read FToggleVisibilities write FToggleVisibilities
default []; |
| Published | property SortSettings: TSortSettings
read FSortSettings write FSortSettings default []; |
| Published | property Header: string read FHeader write FHeader; |
| Published | property Footer: string read FFooter write FFooter; |
| Published | property HtmlBodyBegin: string read FHtmlBodyBegin write FHtmlBodyBegin; |
| Published | property HtmlBodyEnd: string read FHtmlBodyEnd write FHtmlBodyEnd; |
| Published | property HtmlHead: string read FHtmlHead write FHtmlHead; |
| Published | property CSS: string read FCSS write FCSS stored StoredCss; |
| Published | property Bootstrap: boolean read FBootstrap write FBootstrap default true; |
| Published | property NumericFilenames: boolean read FNumericFilenames write FNumericFilenames
default false; |
| Published | property UseTipueSearch: boolean read FUseTipueSearch write FUseTipueSearch
default False; |
| Published | property InheritedMembers: TInheritedMembers
read FInheritedMembers write FInheritedMembers default imNever; |
| Published | property ContentsFile: string read FContentsFile write FContentsFile; |
Description
Constants
| Public | DefaultAutoAbstract = true; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
Fields
| Protected | FLanguage: TPasDocLanguages; |
|
This item is declared in ancestor TDocGenerator. the (human) output language of the documentation file(s) | |
| Protected | FClassHierarchy: TStringCardinalTree; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Protected | FUnits: TPasUnits; |
|
This item is declared in ancestor TDocGenerator. list of all units that were successfully parsed | |
Methods
| Protected | procedure DoError(const AMessage: string; const AArguments: array of const; const AExitCode: Word); |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Protected | procedure DoMessage(const AVerbosity: Cardinal; const MessageType: TPasDocMessageType; const AMessage: string; const AArguments: array of const); |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Protected | procedure CreateClassHierarchy; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Protected | procedure WriteCodeWithLinksCommon(const Item: TPasItem; const Code: string; WriteItemLink: boolean; const NameLinkBegin, NameLinkEnd: string); |
|
This item is declared in ancestor TDocGenerator. This writes Code as a Pascal code. Links inside the code are resolved from Item. If WriteItemLink then Item.Name is made a link. Item.Name is printed between NameLinkBegin and NameLinkEnd. | |
| Protected | function HasSourcePosition(const AItem: TPasItem; out ItemName, ItemFilenameInRoot, ItemUrl: string): boolean; |
|
This item is declared in ancestor TDocGenerator.
Utility to process information from TPasItem.SourceAbsoluteFileName and TPasItem.SourceLine and decide whether to show it. If
Parameters
| |
| Protected | procedure CloseStream; |
|
This item is declared in ancestor TDocGenerator. If field CurrentStream is assigned, it is disposed and set to nil. | |
| Protected | function CreateStream(const AName: string): Boolean; |
|
This item is declared in ancestor TDocGenerator. Open output stream in the destination directory. If CurrentStream still exists (<> nil), it is closed. Then, a new output stream in the destination directory is created and assigned to CurrentStream. The file is overwritten if exists. Use this only for text files that you want to write using WriteXxx methods of this class (like WriteConverted). There's no point to use if for other files. Returns | |
| Protected | function ExtractEmailAddress(s: string; out S1, S2, EmailAddress: string): Boolean; |
|
This item is declared in ancestor TDocGenerator. Searches for an email address in String S. Searches for first appearance of the @ character | |
| Protected | function FixEmailaddressWithoutMailTo(const PossibleEmailAddress: String): String; |
|
This item is declared in ancestor TDocGenerator. Searches for an email address in PossibleEmailAddress and appends mailto: if it's an email address and mailto: wasn't provided. Otherwise it simply returns the input. Needed to link email addresses properly which doesn't start with mailto: | |
| Protected | function ExtractWebAddress(s: string; out S1, S2, WebAddress: string): Boolean; |
|
This item is declared in ancestor TDocGenerator. Searches for a web address in String S. It must either contain a http:// or start with www. | |
| Protected | function FindGlobal(const NameParts: TNameParts): TBaseItem; |
|
This item is declared in ancestor TDocGenerator. Searches all items in all units (given by field Units) for item with NameParts. Returns a pointer to the item on success, nil otherwise. | |
| Protected | function FindGlobalPasItem(const NameParts: TNameParts): TPasItem; overload; |
|
This item is declared in ancestor TDocGenerator.
Find a Pascal item, searching global namespace. Returns | |
| Protected | function FindGlobalPasItem(const ItemName: String): TPasItem; overload; |
|
This item is declared in ancestor TDocGenerator.
Find a Pascal item, searching global namespace. Assumes that Name is only one component (not something with dots inside). Returns | |
| Protected | function GetClassDirectiveName(const Directive: TClassDirective): string; |
|
This item is declared in ancestor TDocGenerator.
| |
| Protected | function GetCIOTypeName(const MyType: TCIOType): string; |
|
This item is declared in ancestor TDocGenerator.
| |
| Protected | procedure LoadDescriptionFile(n: string); |
|
This item is declared in ancestor TDocGenerator. Loads descriptions from file N and replaces or fills the corresponding comment sections of items. | |
| Protected | function SearchItem(s: string; const Item: TBaseItem; WarningIfNotSplittable: boolean): TBaseItem; |
|
This item is declared in ancestor TDocGenerator. Searches for item with name S. If S is not splittable by SplitNameParts, returns nil. If WarningIfNotSplittable, additionally does DoMessage with appropriate warning. Else (if S is "splittable"), seeks for S (first trying Item.FindName, if Item is not nil, then trying FindGlobal). Returns nil if not found. | |
| Protected | function SearchLink(s: string; const Item: TBaseItem; const LinkDisplay: string; const WarningIfLinkNotFound: TLinkNotFoundAction; out FoundItem: TBaseItem): string; overload; |
|
This item is declared in ancestor TDocGenerator. Searches for an item of name S which was linked in the description of Item. Starts search within item, then does a search on all items in all units using FindGlobal. Returns a link as String on success. If S is not splittable by SplitNameParts, it always does DoMessage with appropriate warning and returns something like 'UNKNOWN' (no matter what is the value of WarningIfLinkNotFound). FoundItem will be set to nil in this case. When item will not be found then:
If LinkDisplay is not '', then it specifies explicite the display text for link. Else how exactly link does look like is controlled by LinkLook property. Parameters
| |
| Protected | function SearchLink(s: string; const Item: TBaseItem; const LinkDisplay: string; const WarningIfLinkNotFound: TLinkNotFoundAction): string; overload; |
|
This item is declared in ancestor TDocGenerator. Just like previous overloaded version, but this doesn't return FoundItem (in case you don't need it). | |
| Protected | procedure StoreDescription(ItemName: string; var t: string); |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Protected | procedure WriteConverted(const s: string; Newline: boolean); overload; |
|
This item is declared in ancestor TDocGenerator. Writes S to CurrentStream, converting it using ConvertString. Then optionally writes LineEnding. | |
| Protected | procedure WriteConverted(const s: string); overload; |
|
This item is declared in ancestor TDocGenerator. Writes S to CurrentStream, converting it using ConvertString. No LineEnding at the end. | |
| Protected | procedure WriteConvertedLine(const s: string); |
|
This item is declared in ancestor TDocGenerator. Writes S to CurrentStream, converting it using ConvertString. Then writes LineEnding. | |
| Protected | procedure WriteDirect(const t: string; Newline: boolean); overload; |
|
This item is declared in ancestor TDocGenerator. Simply writes T to CurrentStream, with optional LineEnding. | |
| Protected | procedure WriteDirect(const t: string); overload; |
|
This item is declared in ancestor TDocGenerator. Simply writes T to CurrentStream. | |
| Protected | procedure WriteDirectLine(const t: string); |
|
This item is declared in ancestor TDocGenerator. Simply writes T followed by LineEnding to CurrentStream. | |
| Protected | procedure WriteUnits(const HL: integer); |
|
This item is declared in ancestor TDocGenerator. Writes documentation for all units, calling WriteUnit for each unit. | |
| Protected | procedure WriteGVUses; |
|
This item is declared in ancestor TDocGenerator. output graphviz uses tree | |
| Protected | procedure WriteGVClasses; |
|
This item is declared in ancestor TDocGenerator. output graphviz class tree | |
| Protected | procedure StartSpellChecking(const AMode: string); |
|
This item is declared in ancestor TDocGenerator. starts the spell checker | |
| Protected | procedure CheckString(const AString: string; const AErrors: TSpellingErrorList); |
|
This item is declared in ancestor TDocGenerator. If CheckSpelling and spell checking was successfully started, this will run FAspellProcess.CheckString and will report all errors using DoMessage with mtWarning. Otherwise this just clears AErrors, which means that no errors were found. | |
| Protected | procedure EndSpellChecking; |
|
This item is declared in ancestor TDocGenerator. closes the spellchecker | |
| Protected | function FormatNormalCode(AString: string): string; virtual; |
|
This item is declared in ancestor TDocGenerator. This will cause AString to be formatted in the way that normal Pascal statements (not keywords, strings, comments, etc.) look in Delphi. | |
| Protected | function ShortDash: string; virtual; |
|
This item is declared in ancestor TDocGenerator. See TTagManager.ShortDash. Default implementation in this class returns '-'. | |
| Protected | function LatexString(const S: string): string; virtual; |
|
This item is declared in ancestor TDocGenerator. Process LaTeX content, like provided by the @latex tag. The default implementation is this class simply discards it, i.e. returns always ''. Generators that know what to do with raw LaTeX markup can override this with simple "Result := S". | |
| Protected | procedure WriteExternal(const ExternalItem: TExternalItem; const Id: TTranslationID); |
|
This item is declared in ancestor TDocGenerator. Write the introduction and conclusion of the project. | |
| Protected | procedure WriteConclusion; |
|
This item is declared in ancestor TDocGenerator. Writes a conclusion for the project. See WriteExternal. | |
| Protected | procedure WriteIntroduction; |
|
This item is declared in ancestor TDocGenerator. Writes an introduction for the project. See WriteExternal. | |
| Protected | procedure WriteAdditionalFiles; |
|
This item is declared in ancestor TDocGenerator. Writes the other files for the project. See WriteExternal. | |
| Public | procedure BuildLinks; |
|
This item is declared in ancestor TDocGenerator. Creates anchors and links for all items in all units. | |
| Public | procedure ResolveTypeAliasesDescriptions; |
|
This item is declared in ancestor TDocGenerator. For type aliases with empty RawDescription, copy the RawDescription from the aliased type. Do this only after BuildLinks to be able to follow type aliases. | |
| Public | procedure ExpandDescriptions; |
|
This item is declared in ancestor TDocGenerator. Expands description for each item in each unit of Units. "Expands description" means that TTagManager.Execute is called, and item's DetailedDescription, AbstractDescription, AbstractDescriptionWasAutomatic (and many others, set by @-tags handlers) properties are calculated. | |
| Public | procedure LoadDescriptionFiles(const c: TStringVector); |
|
This item is declared in ancestor TDocGenerator. Assumes C contains file names as PString variables. Calls LoadDescriptionFile with each file name. | |
| Public | procedure ParseAbbreviationsFile(const AFileName: string); |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Protected | function MakeBodyBegin: string; virtual; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Return common HTML content that goes right after <body>. | |
| Protected | function MakeBodyEnd: string; virtual; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Return common HTML content that goes right before </body>. | |
| Protected | function ConvertString(const s: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.ConvertString. Converts for each character in S, thus assembling a String that is returned and can be written to the documentation file. The @ character should not be converted, this will be done later on. | |
| Protected | function ConvertChar(c: char): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Called by ConvertString to convert a character. Will convert special characters to their html escape sequence -> test | |
| Protected | procedure WriteUnit(const HL: integer; const U: TPasUnit); override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.WriteUnit. Abstract method that writes all documentation for a single unit U to output, starting at heading level HL. Implementation must be provided by descendant objects and is dependent on output format. | |
| Protected | function HtmlString(const S: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. overrides TDocGenerator.HtmlString.HtmlString to return the string verbatim (TDocGenerator.HtmlString discards those strings) | |
| Protected | function FormatPascalCode(const Line: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. FormatPascalCode will cause Line to be formatted in the way that Pascal code is formatted in Delphi. | |
| Protected | function FormatComment(AString: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. FormatComment will cause AString to be formatted in the way that comments other than compiler directives are formatted in Delphi. See: FormatCompilerComment. | |
| Protected | function FormatHex(AString: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. FormatHex will cause AString to be formatted in the way that Hex are formatted in Delphi. | |
| Protected | function FormatNumeric(AString: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. FormatNumeric will cause AString to be formatted in the way that Numeric are formatted in Delphi. | |
| Protected | function FormatFloat(AString: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. FormatFloat will cause AString to be formatted in the way that Float are formatted in Delphi. | |
| Protected | function FormatString(AString: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. FormatKeyWord will cause AString to be formatted in the way that strings are formatted in Delphi. | |
| Protected | function FormatKeyWord(AString: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. FormatKeyWord will cause AString to be formatted in the way that reserved words are formatted in Delphi. | |
| Protected | function FormatCompilerComment(AString: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. FormatCompilerComment will cause AString to be formatted in the way that compiler directives are formatted in Delphi. | |
| Protected | function CodeString(const s: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Makes a String look like a coded String, i.e. <CODE>TheString</CODE> in Html. | |
| Protected | function CreateLink(const Item: TBaseItem): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Returns a link to an anchor within a document. HTML simply concatenates the strings with a "#" character between them. | |
| Protected | procedure WriteStartOfCode; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Protected | procedure WriteEndOfCode; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Protected | procedure WriteAnchor(const AName: string); overload; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Protected | procedure WriteAnchor(const AName, Caption: string); overload; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Write an anchor. Note that the Caption is assumed to be already processed with the ConvertString. | |
| Protected | function Paragraph: string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.Paragraph. This is paragraph marker in output documentation. Default implementation in this class simply returns ' ' (one space). | |
| Protected | function EnDash: string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.EnDash. See TTagManager.EnDash. Default implementation in this class returns '--'. | |
| Protected | function EmDash: string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.EmDash. See TTagManager.EmDash. Default implementation in this class returns '---'. | |
| Protected | function LineBreak: string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.LineBreak. Markup that forces line break in given output format (e.g. '<br>' in html or '\\' in LaTeX). It is used on In this class it returns '', because it's valid for an output generator to simply ignore | |
| Protected | function URLLink(const URL: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.URLLink. Markup to display URL in a description. E.g. HTML generator will want to wrap this in <a href="...">...</a>. Note that passed here URL is not processed by ConvertString (because sometimes it could be undesirable). If you want you can process URL with ConvertString when overriding this method. Default implementation in this class simply returns ConvertString(URL). This is good if your documentation format does not support anything like URL links. | |
| Protected | function URLLink(const URL, LinkDisplay: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.URLLink. Text which will be shown for an URL tag. URL is a link to a website or e-mail address. LinkDisplay is an optional parameter which will be used as the display name of the URL. | |
| Protected | procedure WriteExternalCore(const ExternalItem: TExternalItem; const Id: TTranslationID); override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.WriteExternalCore. This is called from WriteExternal when ExternalItem.Title and ShortTitle are already set, message about generating appropriate item is printed etc. This should write ExternalItem, including ExternalItem.DetailedDescription, ExternalItem.Authors, ExternalItem.Created, ExternalItem.LastMod. | |
| Protected | function MakeItemLink(const Item: TBaseItem; const LinkCaption: string; const LinkContext: TLinkContext): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.MakeItemLink. Return a link to item Item which will be displayed as LinkCaption. Returned string may be directly inserted inside output documentation. LinkCaption will be always converted using ConvertString before writing, so don't worry about doing this yourself when calling this method. LinkContext may be used in some descendants to present the link differently, see TLinkContext for it's meaning. If some output format doesn't support this feature, it can return simply ConvertString(LinkCaption). This is the default implementation of this method in this class. | |
| Protected | function EscapeURL(const AString: string): string; virtual; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Protected | function FormatSection(HL: integer; const Anchor: string; const Caption: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatSection. Writes a section heading and a link-anchor. | |
| Protected | function FormatAnchor(const Anchor: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatAnchor. Writes a link-anchor. | |
| Protected | function FormatBold(const Text: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatBold. Return Text formatted using bold font. Given Text is already in the final output format (with characters converted using ConvertString, @-tags expanded etc.). Implementation of this method in this class simply returns | |
| Protected | function FormatItalic(const Text: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatItalic. Return Text formatted using italic font. Analogous to FormatBold. | |
| Protected | function FormatWarning(const Text: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatWarning. Return Text using bold font by calling FormatBold(Text). | |
| Protected | function FormatNote(const Text: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatNote. Return Text using italic font by calling FormatItalic(Text). | |
| Protected | function FormatPreformatted(const Text: string): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatPreformatted. Return Text preserving spaces and line breaks. Note that Text passed here is not yet converted with ConvertString. The implementation of this method in this class just returns ConvertString(Text). | |
| Protected | function FormatImage(FileNames: TStringList): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatImage. Return markup to show an image. FileNames is a list of possible filenames of the image. FileNames always contains at least one item (i.e. FileNames.Count >= 1), never contains empty lines (i.e. Trim(FileNames[I]) <> ''), and contains only absolute filenames. E.g. HTML generator will want to choose the best format for HTML, then somehow copy the image from FileNames[Chosen] and wrap this in <img src="...">. Implementation of this method in this class simply shows | |
| Protected | function FormatList(ListData: TListData): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatList. Format a list from given ListData. | |
| Protected | function FormatTable(Table: TTableData): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatTable. Return appropriate content for given Table. It's guaranteed that the Table passed here will have at least one row and in each row there will be at least one cell, so you don't have to check it within descendants. | |
| Protected | function FormatTableOfContents(Sections: TStringPairVector): string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. Showing description inherited from TDocGenerator.FormatTableOfContents. Override this if you want to insert something on @tableOfContents tag. As a parameter you get already prepared tree of sections that your table of contents should show. Each item of Sections is a section on the level 1. Item's Name is section name, item's Value is section caption, item's Data is a TStringPairVector instance that describes subsections (on level 2) below this section. And so on, recursively. Sections given here are never nil, and item's Data is never nil. But of course they may contain 0 items, and this should be a signal to you that given section doesn't have any subsections. Default implementation of this method in this class just returns empty string. | |
| Public | constructor Create(AOwner: TComponent); override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Public | destructor Destroy; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Public | function GetFileExtension: string; override; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Returns HTML file extension ".htm". | |
| Protected | function MakeHead: string; override; |
|
This item has no description. Showing description inherited from TGenericHTMLDocGenerator.MakeHead. Return common HTML content that goes inside <head>. | |
| Public | procedure WriteDocumentation; override; |
|
This item has no description. Showing description inherited from TGenericHTMLDocGenerator.WriteDocumentation. The method that does everything - writes documentation for all units and creates overview files. | |
Properties
| Protected | property CurrentStream: TStream read FCurrentStream; |
|
This item is declared in ancestor TDocGenerator. Output stream that is currently written to; depending on the output format, more than one output stream may be necessary to store all documentation. | |
| Public | property Units: TPasUnits read FUnits write FUnits; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Public | property Introduction: TExternalItem read FIntroduction
write FIntroduction; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Public | property Conclusion: TExternalItem read FConclusion write FConclusion; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Public | property AdditionalFiles: TExternalItemList read FAdditionalFiles write FAdditionalFiles; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Public | property OnMessage: TPasDocMessageEvent read FOnMessage write FOnMessage; |
|
This item is declared in ancestor TDocGenerator. Callback receiving messages from generator. This is usually used internally by TPasDoc class, that assigns it's internal callback here when using this generator. Also, for the above reason, do not make this published. See TPasDoc.OnMessage for something more useful for final programs. | |
| Published | property Language: TLanguageID read GetLanguage write SetLanguage
default DEFAULT_LANGUAGE; |
|
This item is declared in ancestor TDocGenerator. the (human) output language of the documentation file(s) | |
| Published | property ProjectName: string read FProjectName write FProjectName; |
|
This item is declared in ancestor TDocGenerator. Name of the project to create. | |
| Published | property ExcludeGenerator: Boolean
read FExcludeGenerator write FExcludeGenerator default false; |
|
This item is declared in ancestor TDocGenerator. "Generator info" are things that can change with each invocation of pasdoc, with different pasdoc binary etc. This includes
See --exclude-generator documentation. Default value is false (i.e. show them), as this information is generally considered useful. Setting this to true is useful for automatically comparing two versions of pasdoc's output (e.g. when trying to automate pasdoc's tests). | |
| Published | property IncludeCreationTime: Boolean
read FIncludeCreationTime write FIncludeCreationTime default false; |
|
This item is declared in ancestor TDocGenerator. Show creation time in the output. | |
| Published | property UseLowercaseKeywords: Boolean
read FUseLowercaseKeywords write FUseLowercaseKeywords default false; |
|
This item is declared in ancestor TDocGenerator. Setting to define how literal tag keywords should appear in documentaion. | |
| Published | property Title: string read FTitle write FTitle; |
|
This item is declared in ancestor TDocGenerator. Title of the documentation, supplied by user. May be empty. See TPasDoc.Title. | |
| Published | property DestinationDirectory: string read FDestDir write SetDestDir; |
|
This item is declared in ancestor TDocGenerator. Destination directory for documentation. Must include terminating forward slash or backslash so that valid file names can be created by concatenating DestinationDirectory and a pathless file name. | |
| Published | property OutputGraphVizUses: boolean read FGraphVizUses write FGraphVizUses
default false; |
|
This item is declared in ancestor TDocGenerator. generate a GraphViz diagram for the units dependencies | |
| Published | property OutputGraphVizClassHierarchy: boolean
read FGraphVizClasses write FGraphVizClasses default false; |
|
This item is declared in ancestor TDocGenerator. generate a GraphViz diagram for the Class hierarchy | |
| Published | property LinkGraphVizUses: string read FLinkGraphVizUses write FLinkGraphVizUses; |
|
This item is declared in ancestor TDocGenerator. link the GraphViz uses diagram | |
| Published | property LinkGraphVizClasses: string read FLinkGraphVizClasses write FLinkGraphVizClasses; |
|
This item is declared in ancestor TDocGenerator. link the GraphViz classes diagram | |
| Published | property Abbreviations: TStringList read FAbbreviations write SetAbbreviations; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Published | property CheckSpelling: boolean read FCheckSpelling write FCheckSpelling
default false; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Published | property AspellLanguage: string read FAspellLanguage write FAspellLanguage; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Published | property SpellCheckIgnoreWords: TStringList
read FSpellCheckIgnoreWords write SetSpellCheckIgnoreWords; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Published | property AutoAbstract: boolean
read FAutoAbstract write FAutoAbstract default DefaultAutoAbstract; |
|
This item is declared in ancestor TDocGenerator. Automatically detect abstract (summary) descriptions without @abstract tag. See --auto-abstract command-line option docs on https://pasdoc.github.io/Abstract . This is used in ExpandDescriptions. | |
| Published | property LinkLook: TLinkLook read FLinkLook write FLinkLook default llDefault; |
|
This item is declared in ancestor TDocGenerator. How SearchLink behaves. This meaning is described in --link-look documentation. | |
| Published | property WriteUsesClause: boolean
read FWriteUsesClause write FWriteUsesClause default false; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Published | property AutoLink: boolean
read FAutoLink write FAutoLink default false; |
|
This item is declared in ancestor TDocGenerator. Automatically link identifiers to their documentation, even without @link tags. See --auto-link documentation. | |
| Published | property AutoLinkExclude: TStringList read FAutoLinkExclude; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Published | property ExternalClassHierarchy: TStrings
read FExternalClassHierarchy write SetExternalClassHierarchy
stored StoredExternalClassHierarchy; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Published | property Markdown: boolean
read FMarkdown write FMarkdown default false; |
|
This item is declared in ancestor TDocGenerator. This item has no description. | |
| Published | property ShowSourcePosition: boolean
read FShowSourcePosition write FShowSourcePosition default false; |
|
This item is declared in ancestor TDocGenerator. Show source filename and line number in documentation output. | |
| Published | property SourceRoot: string
read FSourceRoot write FSourceRoot; |
|
This item is declared in ancestor TDocGenerator. Root path for source files. Used to make relative paths, shown by ShowSourcePosition and replaced by SourceUrlPattern. Leave empty to make ShowSourcePosition and SourceUrlPattern just take the final filename part to show / replace. | |
| Published | property SourceUrlPattern: string
read FSourceUrlPattern write FSourceUrlPattern; |
|
This item is declared in ancestor TDocGenerator.
URL pattern for linking source positions. Use | |
| Published | property ToggleVisibilities: TVisibilities
read FToggleVisibilities write FToggleVisibilities
default []; |
|
This item is declared in ancestor TDocGenerator. Visibilities that should be included in output but hidden by default in HTML, with checkboxes to toggle their display. | |
| Published | property SortSettings: TSortSettings
read FSortSettings write FSortSettings default []; |
|
This item is declared in ancestor TDocGenerator. How items should be sorted in output. See --sort documentation. The TPasDoc sorts the items in Units before executing our WriteDocumentation, so TDocGenerator usually doesn't need to worry about sorting anymore... Except if output rearranges/sums items, like HTML output does for InheritedMembers<>imNever, in which case they need to be sorted again. | |
| Published | property Header: string read FHeader write FHeader; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. some HTML code to be written as header for every page | |
| Published | property Footer: string read FFooter write FFooter; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. some HTML code to be written as footer for every page | |
| Published | property HtmlBodyBegin: string read FHtmlBodyBegin write FHtmlBodyBegin; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Published | property HtmlBodyEnd: string read FHtmlBodyEnd write FHtmlBodyEnd; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Published | property HtmlHead: string read FHtmlHead write FHtmlHead; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. This item has no description. | |
| Published | property CSS: string read FCSS write FCSS stored StoredCss; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Contents of the main CSS file (pasdoc.css). | |
| Published | property Bootstrap: boolean read FBootstrap write FBootstrap default true; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. If true, add Bootstrap CSS and JS. Definitions in CSS will be evaluated after Bootstrap's ones. | |
| Published | property NumericFilenames: boolean read FNumericFilenames write FNumericFilenames
default false; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. if set to true, numeric filenames will be used rather than names with multiple dots | |
| Published | property UseTipueSearch: boolean read FUseTipueSearch write FUseTipueSearch
default False; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Enable Tipue fulltext search. See --use-tipue-search documentation. | |
| Published | property InheritedMembers: TInheritedMembers
read FInheritedMembers write FInheritedMembers default imNever; |
|
This item is declared in ancestor TGenericHTMLDocGenerator. Show inherited members (in outputs that make it possible, which right now means only HTML output). | |
| Published | property ContentsFile: string read FContentsFile write FContentsFile; |
|
Contains Name of a file to read HtmlHelp Contents from. If empty, create default contents file. | |
Generated by PasDoc 1.0.2.