Skip to main content

Filter pages for assignments

Project description

File filter plugin for mkdocs

select-files is a mkdocs plugin that filters out files (pages) using a parametrized regular expression.

The main use case for this plugin is to prepare lectures or assignments and only publishing them at a given date.

Quick start

  1. Install the module using pip: pip3 install mkdocs-select-files

  2. In your project, add a plugin configuration to mkdocs.yml:

    plugins:
      - select-files:
       select: '^s(\d+)'
       where: 'lambda x : int(x) <= 5'
    

This would search for files named sNN... and select only those where NN is less than or equal to 5.

In the where expression, you can use the following declared variables

  • now : represent the current time in ISO format
  • sfc : The value of the SELECT_FILE_CONDITION environment variable.

The modules os and datetime are imported, so you can use methods from them.

Disabling the plugin

You can disable the plugin using an environment variable. For example, you could configure your site this way:

plugins:
  - select-files:
  select: '^s(\d+)'
  where: 'lambda x : int(x) <= 5'
  disabled_if_env: SELECT_FILES_DISABLED

and then, running mkdocs with SELECT_FILES_DISABLED set to 1 would disable this plugin and let all pages be processed:

SELECT_FILES_DISABLED=1 mkdocs ...

Credits

Thank you to Lucy Linder for her great idea of using parametrized regular expressions.

Similar plugins

  • mkdocs-exclude : exclude arbitrary file paths and patterns from the input

Project details


Download files

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

Files for mkdocs-select-files, version 0.4.0
Filename, size File type Python version Upload date Hashes
Filename, size mkdocs_select_files-0.4.0-py3-none-any.whl (8.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size mkdocs-select-files-0.4.0.tar.gz (7.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page