Skip to main content

Miyadaiku - Flexible static site generator for Jinja2 artists

Project description

Miyadaiku is a flexible static site generator for Jinja2 artists.

  • Contents are written in reStructuredText, Markdown, HTML, Jupyter Notebook and YAML.

  • Jinja2 templates to create HTML pages.

  • Jinja2 tags can be used in your contents too. Miyadaiku provides ReST/Markdown extensions to write Jinja2 in content files.

  • Hierarchical contents property. Each directory can have default property values for documents. These property values are also applied to contents of their sub-directories.

  • Theme system to share templates, CSS, Javascript, Image or any other contents files.

  • Themes are managed as Python package. You can install themes from PyPI with pip.

  • Generate index pages and Atom/RSS feeds for Blog sites.

Documents

https://miyadaiku.github.io

Requirements

Miydaiku requires Python 3.7 or later.

Installation

Use pip to install miyadaiku.

$ pip3 install miyadaiku

History

1.25.0

  • Support target markup in ipynb files

1.24.1

  • Support recent python-markdown.

1.24.0

  • strip_directory_index property specifies a file name to be striped from the page URL.

1.23.0

  • Support new version of tzlocal module.

1.22.0

  • <meta http-equiv=”refresh” …> element is emitted if refresh_to property is path to the target page.

  • search argument of context.link_to() is not regular expression but plain text.

1.21.1

  • updated property is used as updated element of feed if specified.

  • search argument of context.link_to() is not regular expression but plain text.

1.21.0

  • abstract_html property specifies static abstract text of content in HTML.

1.20.0

  • Fix bug in jinja tag extraction.

  • short_header_id to generate short header id.

1.19.0

  • Support Python 3.9.0

  • nbconvert themes can be installed in nb_templates directory.

1.18.0

  • Add bases to the jinja variable.

  • Add ipynb_export_options config for nbexport option. Default to

    {"TagRemovePreprocessor": {
        "remove_cell_tags": ["remove_cell"],
        "remove_all_outputs_tags": ["remove_output"],
        "remove_input_tags": ["remove_input"]
        },
    }
  • Support nbconvert >= 6.0.

  • Improve file cache.

  • Add content.loader property.

1.17.0

  • :jinja:`` tag can be used in Jupyter markdown cell.

  • Generates sitemap

1.16.0

  • Removed div and a elements around headers.

1.15.0

  • Add context.get_url().

  • Deprecate ContentPropxy.url property.

1.14.0

  • Add directories property to index and feed.

  • Update samile contents created by miyadaiku-start command.

  • Rebuild if YAML files in the project contents directory are updated.

  • Escape :jinja:`` notation in markdown.

1.13.0

  • Support .txt file type.

  • Wrong tzinfo was picked to apply default timezone.

  • File name with extension ‘.j2’ is treated as HTML.

  • Ignore Yaml declarations which does not return dict.

  • New property: updated.

1.12.0

  • Build title from abstract if title_fallback is title and header element not found in the content.

  • Preserve newline in content.abstract.

  • Add .anchor-link style for .ipynb file.

  • YAML can be used in HTML content.

  • Add setattr/getattr to jinja variables.

  • Modified convention of anchor name generation.

  • Add search option to link()/link_to().

Upgrading to Miyadaiku 1.0.0

Miyadaiku 1.0.0 has some incompatible changes.

To upgrade from older version of Miyadaiku, please read following notes.

  1. Package name of external themes are changed.

    • miyadaiku.themes.bootstrap4 -> miyadaiku_theme_bootstrap4

    • miyadaiku.themes.jquery -> miyadaiku_theme_jquery

    • miyadaiku.themes.tether -> miyadaiku_theme_tether

    • miyadaiku.themes.fontawesome-> miyadaiku_theme_fontawesome

    • miyadaiku.themes.popper_js -> miyadaiku_theme_popper_js

  2. Argument names of some method of Miydaiku objects are changed.

    • value argument of path(), path_to(), link(), link_to() methods are renamed to group_value.

    • group_values jinja variable is renamed to group_value.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

miyadaiku-1.26.0-py3-none-any.whl (90.1 kB view details)

Uploaded Python 3

File details

Details for the file miyadaiku-1.26.0-py3-none-any.whl.

File metadata

  • Download URL: miyadaiku-1.26.0-py3-none-any.whl
  • Upload date:
  • Size: 90.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.0

File hashes

Hashes for miyadaiku-1.26.0-py3-none-any.whl
Algorithm Hash digest
SHA256 491f7835c1e69015780946cef989ab1c442f073694cfca1873ff43310afe5325
MD5 1b0e901f047bddd1ecaf7ee87be8492a
BLAKE2b-256 0a879f6355d355cc2dcceea17ad71ebcaad88e7842651d0b30a20cbd8ff667ba

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page