perkeep/pkg/publish/types.go

99 lines
3.9 KiB
Go

/*
Copyright 2013 The Perkeep Authors.
Licensed under the Apache 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://www.apache.org/licenses/LICENSE-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 publish exposes the types and functions that can be used
// from a Go template, for publishing.
package publish // import "perkeep.org/pkg/publish"
import (
"html/template"
"perkeep.org/pkg/blob"
"perkeep.org/pkg/search"
)
// SubjectPage is the data structure used when serving a
// publishing template. It contains the functions that can be called
// from the template.
type SubjectPage struct {
Header func() *PageHeader
File func() *PageFile
Members func() *PageMembers
}
// PageHeader contains the data available to the template,
// and relevant to the page header.
type PageHeader struct {
Title string // Page title.
CSSFiles []string // Available CSS files.
JSDeps []string // Dependencies (for e.g closure) that can/should be included as javascript files.
CamliClosure template.JS // Closure namespace defined in the provided js. e.g camlistore.GalleryPage from pics.js
Subject blob.Ref // Subject of this page (i.e the object which is described and published).
ViewerIsOwner bool // Whether the viewer of the page is also the owner of the displayed subject. (localhost check for now.)
PublishedRoot blob.Ref // Root permanode for this publisher. On camliRoot, camliPath:somePath = publishedRoot
// SubjectBasePath is the URL path up to the digest prefix of the
// subject. e.g. "/pics/foo/-/h341b133369" or "/pics/foo/-" if the subject
// is the published root itself.
SubjectBasePath string
// PathPrefix is the publisher app handler prefix on Perkeep, e.g.
// "/pics/", or "/" if the request was not proxied through Perkeep.
PathPrefix string
Host string
}
// PageFile contains the file related data available to the subject template,
// if the page describes some file contents.
type PageFile struct {
FileName string
Size int64
MIMEType string
IsImage bool
DownloadURL string
ThumbnailURL string
DomID string
Nav func() *Nav
}
// Nav holds links to the previous, next, and parent elements,
// when displaying members.
type Nav struct {
ParentPath string
PrevPath string
NextPath string
}
// PageMembers contains the data relevant to the members if the published subject
// is a permanode with members.
type PageMembers struct {
SubjectPath string // URL prefix path to the subject (i.e the permanode).
ZipName string // Name of the downloadable zip file which contains all the members.
Members []*search.DescribedBlob // List of the members.
Description func(*search.DescribedBlob) string // Returns the description of the given member.
Title func(*search.DescribedBlob) string // Returns the title for the given member.
Path func(*search.DescribedBlob) string // Returns the url prefix path to the given the member.
DomID func(*search.DescribedBlob) string // Returns the Dom ID of the given member.
FileInfo func(*search.DescribedBlob) *MemberFileInfo // Returns some file info if the given member is a file permanode.
}
// MemberFileInfo contains the file related data available for each member,
// if the member is the permanode for a file.
type MemberFileInfo struct {
FileName string
FileDomID string
FilePath string
FileThumbnailURL string
}