build.Page Class Reference

Inheritance diagram for build.Page:

Public Member Functions
def	__init__ (self, str name)
def	__repr__ (self)
def	depends_on (self, str path)
def	build (self)
def	__init__ (self, str output, Sequence[str] inputs)
bool	depends_on (self, str path)
def	build (self)

Public Attributes
	name
	inputs
Public Attributes inherited from build.Artifact
	output
	inputs

Additional Inherited Members
Static Public Member Functions inherited from build.Artifact
def	build_all ()
def	build_matching (Callable[[Artifact], bool] predicate)

Detailed Description

A single wiki Page (a markdown file).

Definition at line 130 of file build.py.

Constructor & Destructor Documentation

__init__()

def build.Page.__init__	(		self,
		str	name
	)

Reimplemented from build.Artifact.

Definition at line 133 of file build.py.

    def __init__(self, name: str):
        self.name = name
        output_name = 'index' if name == 'README' else name
        super().__init__(os.path.join(OUTPUT_DIR, f'{output_name}.html'),
                         [os.path.join(WIKI_SOURCE_DIR, f'{name}.md')])
 

Member Function Documentation

__repr__()

def build.Page.__repr__

(

self

)

Definition at line 139 of file build.py.

    def __repr__(self):
        return f'Page({self.output} <- {self.inputs[0]})'
 

build()

def build.Page.build

(

self

)

Convert artifact inputs into an output.

Reimplemented from build.Artifact.

Definition at line 172 of file build.py.

    def build(self):
        logging.info('Build %s from %s', self.output, self.inputs[0])
 
        template = jinja2_env.get_template(PAGE_TEMPLATE)
        md_converter = markdown.Markdown(extensions=[
            'admonition',
            'extra',
            CodeHiliteExtension(),
            'tables',
            'pymdownx.superfences',
            'toc',
            xref_extension,
        ])
        result = template.render({
            'dev':
            is_dev_mode,
            'body':
            md_converter.convert(self._load_markdown()),
            'root':
            deployment_root
        })
        # pylint: disable=no-member
        if not is_dev_mode and len(md_converter.xrefs) > 0:
            self._update_xref_section(md_converter.xrefs)
 
        os.makedirs(os.path.dirname(self.output), exist_ok=True)
        with codecs.open(self.output, "w", encoding='utf-8') as file:
            file.write(result)
 
        template_filename = template.filename  # pytype: disable=attribute-error
        self.inputs = [self.inputs[0], template_filename]
 
 

depends_on()

def build.Page.depends_on	(		self,
		str	path
	)

Check if this

Reimplemented from build.Artifact.

Definition at line 142 of file build.py.

    def depends_on(self, path: str):
        return path.startswith(TEMPLATES_INCLUDES_DIR) or super().depends_on(
            path)
 

Member Data Documentation

inputs

build.Page.inputs

Definition at line 202 of file build.py.

name

build.Page.name

Definition at line 134 of file build.py.

---

The documentation for this class was generated from the following file:

• third_party/dart-lang/sdk/runtime/tools/wiki/build/build.py