zola

  • 1
  • 2
  • 3

0.14.1 | Updated: 02 Sep 2021

Downloads:

2,948

Downloads of v 0.14.1:

160

Maintainer(s):

Software Author(s):

  • Vincent Prouillet
  • zola contributors

  • 1
  • 2
  • 3
zola 0.14.1

  • 1
  • 2
  • 3

All Checks are Passing

3 Passing Tests


Validation Testing Passed


Verification Testing Passed

Details

Scan Testing Successful:

No detections found in any package files

Details

To install zola, run the following command from the command line or from PowerShell:

>

To upgrade zola, run the following command from the command line or from PowerShell:

>

To uninstall zola, run the following command from the command line or from PowerShell:

>

NOTE: This applies to both open source and commercial editions of Chocolatey.

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to https://community.chocolatey.org/api/v2. Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Enter your internal repository url

(this should look similar to https://community.chocolatey.org/api/v2)

4. Choose your deployment method:


choco upgrade zola -y --source="'STEP 3 URL'" [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:


choco upgrade zola -y --source="'STEP 3 URL'"
$exitCode = $LASTEXITCODE

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0
}

Exit $exitCode

- name: Ensure zola installed
  win_chocolatey:
    name: zola
    state: present
    version: 0.14.1
    source: STEP 3 URL

See docs at https://docs.ansible.com/ansible/latest/modules/win_chocolatey_module.html.


chocolatey_package 'zola' do
  action    :install
  version  '0.14.1'
  source   'STEP 3 URL'
end

See docs at https://docs.chef.io/resource_chocolatey_package.html.


Chocolatey::Ensure-Package
(
    Name: zola,
    Version: 0.14.1,
    Source: STEP 3 URL
);

Requires Otter Chocolatey Extension. See docs at https://inedo.com/den/otter/chocolatey.


cChocoPackageInstaller zola
{
   Name     = 'zola'
   Ensure   = 'Present'
   Version  = '0.14.1'
   Source   = 'STEP 3 URL'
}

Requires cChoco DSC Resource. See docs at https://github.com/chocolatey/cChoco.


package { 'zola':
  provider => 'chocolatey',
  ensure   => '0.14.1',
  source   => 'STEP 3 URL',
}

Requires Puppet Chocolatey Provider module. See docs at https://forge.puppet.com/puppetlabs/chocolatey.


salt '*' chocolatey.install zola version="0.14.1" source="STEP 3 URL"

See docs at https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.chocolatey.html.

5. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

Private CDN cached downloads available for licensed customers. Never experience 404 breakages again! Learn more...

This package was approved as a trusted package on 02 Sep 2021.

Description

A fast static site generator in a single binary with everything built-in. Documentation is available on its site or
in the docs/content folder of the repository.

Supported content formats

  • Zola: markdown
  • Cobalt: markdown
  • Hugo: markdown, asciidoc, org-mode
  • Pelican: reStructuredText, markdown, asciidoc, org-mode, whatever-you-want

Template engine explanation

Cobalt gets ~ as, while based on Liquid, the Rust library doesn't implement all its features but there is no documentation on what is and isn't implemented. The errors are also cryptic. Liquid itself is not powerful enough to do some of things you can do in Jinja2, Go templates or Tera.

Hugo gets ~. It is probably the most powerful template engine in the list after Jinja2 (hard to beat python code in templates) but personally drives me insane, to the point of writing my own template engine and static site generator. Yes, this is a bit biased.

Pelican notes

Many features of Pelican are coming from plugins, which might be tricky
to use because of version mismatch or lacking documentation. Netlify supports Python
and Pipenv but you still need to install your dependencies manually.

Contributing

As the documentation site is automatically built on commits to master, all development
should happen on the next branch, unless it is fixing the current documentation.

If you want a feature added or modified, please open an issue to discuss it before doing a PR.


tools\chocolateyInstall.ps1
$ErrorActionPreference = 'Stop'

$packageName= $env:ChocolateyPackageName
$toolsDir   = "$(Split-Path -parent $MyInvocation.MyCommand.Definition)"
$url      = "https://github.com/getzola/zola/releases/download/v$($env:ChocolateyPackageVersion)/zola-v$($env:ChocolateyPackageVersion)-x86_64-pc-windows-msvc.zip"

$packageArgs = @{
  packageName   = $packageName
  unzipLocation = $toolsDir
  url           = $url
  checksum      = '62BF50A6E2B606FAF80CDF9112DECA945FE89F67863FB06F793C27A26C968A91'
  checksumType  = 'sha256'
}

Install-ChocolateyZipPackage @packageArgs

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Version Downloads Last Updated Status
zola 0.14.0 103 Saturday, August 7, 2021 Approved
zola 0.13.0 392 Tuesday, March 9, 2021 Approved
zola 0.12.2 425 Monday, September 28, 2020 Approved
zola 0.12.1 41 Monday, September 28, 2020 Approved
zola 0.12.0 70 Sunday, September 20, 2020 Approved
zola 0.11.0 300 Monday, May 25, 2020 Approved
zola 0.10.1 244 Friday, March 13, 2020 Approved
zola 0.10.0 153 Tuesday, February 18, 2020 Approved
zola 0.9.0 285 Saturday, October 5, 2019 Approved

0.14.0 (2021-07-19)

Breaking

  • Newlines are now required after the closing +++ of front-matter
  • resize_image now returns an object: {url, static_path} instead of just the URL so you can follow up with other functions on the new file if needed
  • get_file_hash now has the base64 option set to true by default (from false) since it's mainly used for integrity hashes which are base64
  • i18n rework: languages now have their sections in config.toml to set up all their options
    1. taxonomies don't have a lang anymore in the config, you need to declare them in their respective language section
    2. the config variable in templates has been changed and is now a stripped down language aware version of the previous config
      object
    3. Search settings are now language specific
    4. Translations are now nested in the languages table
  • Paths unification:
    1. get_url does not load automatically from the static folder anymore
    2. New path resolving logic for all on-disk files: replace @/ by content/, trim leading / and
      search in $BASE_DIR + $path, $BASE_DIR + static + $path and $BASE_DIR + content + $path
    3. get_file_hash now returns base64 encoded hash by default
    4. all functions working on files can now only load files in the Zola directory
    5. resize_image return value has changed
    6. page.assets now start with a / to match section.assets and other paths

Other

  • Internal links are now resolved in the markdown filter in the templates (#1296 #1316)
  • Add a required argument to load_data so it can be allowed to fail
  • get_file_hash now supports returning the base64 encoded hash
  • The markdown filter not renders shortcodes
  • Image processing now supports WebP
  • Fix zola serve failing for some static files
  • Fix zola serve not picking up directory renaming
  • Add path to the taxonomy terms to be on par with pages and sections
  • Add the base16-aterlierdune-light syntax highlight theme
  • Improve link checking: less concurrency and try to not overload the servers
  • Allow using POST for load_data, along with a body to POST and allow it to fail
  • Add Zig and Protobuf syntax highlighting
  • Footnotes links are now stripped from summaries - they were not linking to anything.
  • get_url and get_taxonomy_url are now marked as safe, no need to call | safe on their output
  • Add allow_missing optional argument to get_image_metadata to not error if the file is not found
  • Add permalink to Taxonomy in templates
  • Syntax highlighting improvements, see documentation for details on each
    1. Add CSS class based syntax highlighting
    2. Allow hiding specific lines
    3. Allow showing line numbers

This package has no dependencies.

Discussion for the zola Package

Ground Rules:

  • This discussion is only about zola and the zola package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or zola, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus