mirror of https://github.com/knative/docs.git
40 lines
2.0 KiB
Python
40 lines
2.0 KiB
Python
import os
|
|
|
|
def define_env(env):
|
|
|
|
@env.macro
|
|
def feature(alpha="", beta="", stable=""):
|
|
versions = []
|
|
descriptions = []
|
|
if alpha != "":
|
|
versions.append('<span class="feature-alpha">alpha</span> since Knative v{version}'.format(version=alpha))
|
|
descriptions.append(' - <span class="feature-alpha">alpha</span> features are experimental, and may change or be removed without notice.')
|
|
if beta != "":
|
|
versions.append('<span class="feature-beta">beta</span> since Knative v{version}'.format(version=beta))
|
|
descriptions.append(' - <span class="feature-beta">beta</span> features are well-tested and enabling them is considered safe. Support for the overall feature will not be dropped, though details may change in incompatible ways.')
|
|
if stable != "":
|
|
versions.append('<span class="feature-stable">stable</span> since Knative v{version}'.format(version=stable))
|
|
descriptions.append(' - <span class="feature-stable">stable</span> features will be maintained for many future versions.')
|
|
return '??? info "Feature Availability: ' + ', '.join(versions) + '"\n' + '\n'.join(descriptions)
|
|
|
|
@env.macro
|
|
def artifact(repo, file, org="knative"):
|
|
"""Generates a download link for the current release version.
|
|
|
|
When the version in the KNATIVE_VERSION environment variable is
|
|
empty this links to googlestorage, otherwise it links via
|
|
the matching release in github.
|
|
"""
|
|
version = os.environ.get("KNATIVE_VERSION")
|
|
if version == None:
|
|
return 'https://storage.googleapis.com/{org}-nightly/{repo}/latest/{file}'.format(
|
|
repo=repo,
|
|
file=file,
|
|
org=org)
|
|
else:
|
|
return 'https://github.com/{org}/{repo}/releases/download/{version}/{file}'.format(
|
|
repo=repo,
|
|
file=file,
|
|
version=version,
|
|
org=org)
|