// Copyright © 2013-14 Steve Francia . // // Licensed under the Simple Public License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // http://opensource.org/licenses/Simple-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package hugolib import ( "errors" "fmt" "github.com/spf13/cast" "github.com/spf13/hugo/helpers" "github.com/spf13/viper" "html/template" "math" "path" "reflect" "strings" ) type Pager struct { number int *paginator } type pagers []*Pager var paginatorEmptyPages Pages type paginator struct { paginatedPages []Pages pagers paginationURLFactory total int size int source interface{} options []interface{} } type paginationURLFactory func(int) string // PageNumber returns the current page's number in the pager sequence. func (p *Pager) PageNumber() int { return p.number } // URL returns the URL to the current page. func (p *Pager) URL() template.HTML { return template.HTML(p.paginationURLFactory(p.PageNumber())) } // Url is deprecated. Will be removed in 0.15. func (p *Pager) Url() template.HTML { helpers.Deprecated("Paginator", ".Url", ".URL") return p.URL() } // Pages returns the elements on this page. func (p *Pager) Pages() Pages { if len(p.paginatedPages) == 0 { return paginatorEmptyPages } return p.paginatedPages[p.PageNumber()-1] } // NumberOfElements gets the number of elements on this page. func (p *Pager) NumberOfElements() int { return len(p.Pages()) } // HasPrev tests whether there are page(s) before the current. func (p *Pager) HasPrev() bool { return p.PageNumber() > 1 } // Prev returns the pager for the previous page. func (p *Pager) Prev() *Pager { if !p.HasPrev() { return nil } return p.pagers[p.PageNumber()-2] } // HasNext tests whether there are page(s) after the current. func (p *Pager) HasNext() bool { return p.PageNumber() < len(p.paginatedPages) } // Next returns the pager for the next page. func (p *Pager) Next() *Pager { if !p.HasNext() { return nil } return p.pagers[p.PageNumber()] } // First returns the pager for the first page. func (p *Pager) First() *Pager { return p.pagers[0] } // Last returns the pager for the last page. func (p *Pager) Last() *Pager { return p.pagers[len(p.pagers)-1] } // Pagers returns a list of pagers that can be used to build a pagination menu. func (p *paginator) Pagers() pagers { return p.pagers } // PageSize returns the size of each paginator page. func (p *paginator) PageSize() int { return p.size } // TotalPages returns the number of pages in the paginator. func (p *paginator) TotalPages() int { return len(p.paginatedPages) } // TotalNumberOfElements returns the number of elements on all pages in this paginator. func (p *paginator) TotalNumberOfElements() int { return p.total } func splitPages(pages Pages, size int) []Pages { var split []Pages for low, j := 0, len(pages); low < j; low += size { high := int(math.Min(float64(low+size), float64(len(pages)))) split = append(split, pages[low:high]) } return split } // Paginator gets this Node's paginator if it's already created. // If it's not, one will be created with all pages in Data["Pages"]. func (n *Node) Paginator(options ...interface{}) (*Pager, error) { pagerSize, err := resolvePagerSize(options...) if err != nil { return nil, err } var initError error n.paginatorInit.Do(func() { if n.paginator != nil { return } pagers, err := paginatePages(n.Data["Pages"], pagerSize, n.URL) if err != nil { initError = err } if len(pagers) > 0 { // the rest of the nodes will be created later n.paginator = pagers[0] n.paginator.source = "paginator" n.paginator.options = options n.Site.addToPaginationPageCount(uint64(n.paginator.TotalPages())) } }) if initError != nil { return nil, initError } return n.paginator, nil } // Paginator on Page isn't supported, calling this yields an error. func (p *Page) Paginator(options ...interface{}) (*Pager, error) { return nil, errors.New("Paginators not supported for content pages.") } // Paginate on Page isn't supported, calling this yields an error. func (p *Page) Paginate(seq interface{}, options ...interface{}) (*Pager, error) { return nil, errors.New("Paginators not supported for content pages.") } // Paginate gets this Node's paginator if it's already created. // If it's not, one will be created with the qiven sequence. // Note that repeated calls will return the same result, even if the sequence is different. func (n *Node) Paginate(seq interface{}, options ...interface{}) (*Pager, error) { pagerSize, err := resolvePagerSize(options...) if err != nil { return nil, err } var initError error n.paginatorInit.Do(func() { if n.paginator != nil { return } pagers, err := paginatePages(seq, pagerSize, n.URL) if err != nil { initError = err } if len(pagers) > 0 { // the rest of the nodes will be created later n.paginator = pagers[0] n.paginator.source = seq n.paginator.options = options n.Site.addToPaginationPageCount(uint64(n.paginator.TotalPages())) } }) if initError != nil { return nil, initError } if n.paginator.source == "paginator" { return nil, errors.New("a Paginator was previously built for this Node without filters; look for earlier .Paginator usage") } if !reflect.DeepEqual(options, n.paginator.options) || !probablyEqualPageLists(n.paginator.source, seq) { return nil, errors.New("invoked multiple times with different arguments") } return n.paginator, nil } func resolvePagerSize(options ...interface{}) (int, error) { if len(options) == 0 { return viper.GetInt("paginate"), nil } if len(options) > 1 { return -1, errors.New("too many arguments, 'pager size' is currently the only option") } pas, err := cast.ToIntE(options[0]) if err != nil || pas <= 0 { return -1, errors.New(("'pager size' must be a positive integer")) } return pas, nil } func paginatePages(seq interface{}, pagerSize int, section string) (pagers, error) { if pagerSize <= 0 { return nil, errors.New("'paginate' configuration setting must be positive to paginate") } pages, err := toPages(seq) if err != nil { return nil, err } section = strings.TrimSuffix(section, ".html") urlFactory := newPaginationURLFactory(section) paginator, _ := newPaginator(pages, pagerSize, urlFactory) pagers := paginator.Pagers() return pagers, nil } func toPages(seq interface{}) (Pages, error) { switch seq.(type) { case Pages: return seq.(Pages), nil case *Pages: return *(seq.(*Pages)), nil case WeightedPages: return (seq.(WeightedPages)).Pages(), nil case PageGroup: return (seq.(PageGroup)).Pages, nil default: return nil, fmt.Errorf("unsupported type in paginate, got %T", seq) } } // probablyEqual checks page lists for probable equality. // It may return false positives. // The motivation behind this is to avoid potential costly reflect.DeepEqual // when "probably" is good enough. func probablyEqualPageLists(a1 interface{}, a2 interface{}) bool { if a1 == nil || a2 == nil { return a1 == a2 } p1, err1 := toPages(a1) p2, err2 := toPages(a2) // probably the same wrong type if err1 != nil && err2 != nil { return true } if err1 != nil || err2 != nil { return false } if len(p1) != len(p2) { return false } if len(p1) == 0 { return true } return p1[0] == p2[0] } func newPaginator(pages Pages, size int, urlFactory paginationURLFactory) (*paginator, error) { if size <= 0 { return nil, errors.New("Paginator size must be positive") } split := splitPages(pages, size) p := &paginator{total: len(pages), paginatedPages: split, size: size, paginationURLFactory: urlFactory} var ps pagers if len(split) > 0 { ps = make(pagers, len(split)) for i := range p.paginatedPages { ps[i] = &Pager{number: (i + 1), paginator: p} } } else { ps = make(pagers, 1) ps[0] = &Pager{number: 1, paginator: p} } p.pagers = ps return p, nil } func newPaginationURLFactory(pathElements ...string) paginationURLFactory { paginatePath := viper.GetString("paginatePath") return func(page int) string { var rel string if page == 1 { rel = fmt.Sprintf("/%s/", path.Join(pathElements...)) } else { rel = fmt.Sprintf("/%s/%s/%d/", path.Join(pathElements...), paginatePath, page) } return helpers.URLizeAndPrep(rel) } }