urls

Documentation

Overview

Package urls provides template functions to deal with URLs.

Index

• type Namespace
  • func New(deps *deps.Deps) *Namespace
  • func (ns *Namespace) AbsLangURL(s any) (template.HTML, error)
  • func (ns *Namespace) AbsURL(s any) (template.HTML, error)
  • func (ns *Namespace) Anchorize(s any) (string, error)
  • func (ns *Namespace) JoinPath(elements ...any) (string, error)
  • func (ns *Namespace) Parse(rawurl any) (*url.URL, error)
  • func (ns *Namespace) Ref(p any, args any) (template.HTML, error)
  • func (ns *Namespace) RelLangURL(s any) (template.HTML, error)
  • func (ns *Namespace) RelRef(p any, args any) (template.HTML, error)
  • func (ns *Namespace) RelURL(s any) (template.HTML, error)
  • func (ns *Namespace) URLize(s any) (string, error)

Types

type Namespace

type Namespace struct {
	// contains filtered or unexported fields
}

Namespace provides template functions for the "urls" namespace.

func New

func New(deps *deps.Deps) *Namespace

New returns a new instance of the urls-namespaced template functions.

func (*Namespace) AbsLangURL

func (ns *Namespace) AbsLangURL(s any) (template.HTML, error)

AbsLangURL the string s and converts it to an absolute URL according to a page's position in the project directory structure and the current language.

func (*Namespace) AbsURL

func (ns *Namespace) AbsURL(s any) (template.HTML, error)

AbsURL takes the string s and converts it to an absolute URL.

func (*Namespace) Anchorize

func (ns *Namespace) Anchorize(s any) (string, error)

Anchorize creates sanitized anchor name version of the string s that is compatible with how your configured markdown renderer does it.

func (*Namespace) JoinPath

func (ns *Namespace) JoinPath(elements ...any) (string, error)

JoinPath joins the provided elements into a URL string and cleans the result of any ./ or ../ elements. If the argument list is empty, JoinPath returns an empty string.

func (*Namespace) Parse

func (ns *Namespace) Parse(rawurl any) (*url.URL, error)

Parse parses rawurl into a URL structure. The rawurl may be relative or absolute.

func (*Namespace) Ref

func (ns *Namespace) Ref(p any, args any) (template.HTML, error)

Ref returns the absolute URL path to a given content item from Page p.

func (*Namespace) RelLangURL

func (ns *Namespace) RelLangURL(s any) (template.HTML, error)

RelLangURL takes the string s and prepends the relative path according to a page's position in the project directory structure and the current language.

func (*Namespace) RelRef

func (ns *Namespace) RelRef(p any, args any) (template.HTML, error)

RelRef returns the relative URL path to a given content item from Page p.

func (*Namespace) RelURL

func (ns *Namespace) RelURL(s any) (template.HTML, error)

RelURL takes the string s and prepends the relative path according to a page's position in the project directory structure.

func (*Namespace) URLize

func (ns *Namespace) URLize(s any) (string, error)

URLize returns the the strings s formatted as an URL.