GBApplicationSettingsProviding Protocol Reference

Declared in GBApplicationSettingsProviding.h

Overview

Defines the requirements for application-level settings providers.

Application-level settings providers provide application-wide settings and properties that affect application handling.

Tasks

Template paths handling

Output paths handling

Other paths handling

Helper classes

Instance Methods

htmlOutputPathForIndex

Returns file name including full path for HTML file representing the main index.

- (NSString *)htmlOutputPathForIndex

Return Value

Returns the path.

Discussion

Returns file name including full path for HTML file representing the main index.

Declared In

GBApplicationSettingsProviding.h

htmlOutputPathForObject:

Returns file name including full path for HTML file representing the given top-level object.

- (NSString *)htmlOutputPathForObject:(GBModelBase *)object

Parameters

object
The object for which to return the path.

Return Value

Returns the path.

Discussion

Returns file name including full path for HTML file representing the given top-level object.

This works for any top-level object: class, category or protocol. The path is automatically determined regarding to the object class.

Exceptions

NSException
Thrown if the given object is nil or not top-level object.

Declared In

GBApplicationSettingsProviding.h

htmlReferenceForObject:fromSource:

Returns relative HTML reference to the given object from the context of the given source object.

- (NSString *)htmlReferenceForObject:(GBModelBase *)object fromSource:(GBModelBase *)source

Parameters

object
The object for which to generate the reference to.
source
The source object from which to generate the reference from or nil for index to object reference.

Return Value

Returns the reference string.

Discussion

Returns relative HTML reference to the given object from the context of the given source object.

This is useful for generating hrefs from one object HTML file to another. This is the swiss army knife king of a method for all hrefs generation. It works for any kind of links:

  • Index to top-level object (if source is nil ).
  • Index to a member of a top-level object (if source is nil ).
  • Top-level object to same top-level object.
  • Top-level object to a different top-level object.
  • Top-level object to one of it's members.
  • Member object to it's top-level object.
  • Member object to another top-level object.
  • Member object to another member of the same top-level object.
  • Member object to a member of another top-level object.

Exceptions

NSException
Thrown if object is nil .

Declared In

GBApplicationSettingsProviding.h

htmlReferenceNameForObject:

Returns HTML reference name for the given object.

- (NSString *)htmlReferenceNameForObject:(GBModelBase *)object

Parameters

object
The object for which to return reference name.

Return Value

Returns the reference name of the object.

Discussion

Returns HTML reference name for the given object.

This should only be used for creating anchors that need to be referenced from other parts of the same HTML file. The method works for top-level objects as well as their members.

Exceptions

NSException
Thrown if the given object is nil .

Declared In

GBApplicationSettingsProviding.h

Properties

commentComponents

Returns the GBCommentComponentsProvider object that identifies comment components.

@property (retain) GBCommentComponentsProvider *commentComponents

Discussion

Returns the GBCommentComponentsProvider object that identifies comment components.

Declared In

GBApplicationSettingsProviding.h

cssCategoryTemplatePath

The path to the CSS template file, relative from category html files.

@property (readonly) NSString *cssCategoryTemplatePath

Discussion

The path to the CSS template file, relative from category html files.

Declared In

GBApplicationSettingsProviding.h

cssClassTemplatePath

The path to the CSS template file, relative from class html files.

@property (readonly) NSString *cssClassTemplatePath

Discussion

The path to the CSS template file, relative from class html files.

Declared In

GBApplicationSettingsProviding.h

cssIndexTemplatePath

The path to the CSS template file, relative from index html files.

@property (readonly) NSString *cssIndexTemplatePath

Discussion

The path to the CSS template file, relative from index html files.

Declared In

GBApplicationSettingsProviding.h

cssProtocolTemplatePath

The path to the CSS template file, relative from protocol html files.

@property (readonly) NSString *cssProtocolTemplatePath

Discussion

The path to the CSS template file, relative from protocol html files.

Declared In

GBApplicationSettingsProviding.h

htmlOutputPath

The base path of the HTML generated files.

@property (readonly) NSString *htmlOutputPath

Discussion

The base path of the HTML generated files.

This value depends on outputPath and is automatically calculated.

Declared In

GBApplicationSettingsProviding.h

ignoredPaths

The list of all full or partial paths to be ignored.

@property (retain) NSMutableArray *ignoredPaths

Discussion

The list of all full or partial paths to be ignored.

It's recommended to check if a path string ends with any of the given paths before processing it. This should catch directory and file names properly as directories are processed first.

Declared In

GBApplicationSettingsProviding.h

outputPath

The base path of the generated files.

@property (copy) NSString *outputPath

Discussion

The base path of the generated files.

Declared In

GBApplicationSettingsProviding.h

stringTemplates

Returns the GBApplicationStringsProvider object that specifies all string templates used for output generation.

@property (retain) GBApplicationStringsProvider *stringTemplates

Discussion

Returns the GBApplicationStringsProvider object that specifies all string templates used for output generation.

Declared In

GBApplicationSettingsProviding.h

templatesPath

The base path to template files used for generating various output files.

@property (copy) NSString *templatesPath

Discussion

The base path to template files used for generating various output files.

Declared In

GBApplicationSettingsProviding.h