2018-09-29 11:33:54 +03:00
// Copyright 2018 The Gitea Authors. All rights reserved.
2014-04-10 22:20:58 +04:00
// Copyright 2014 The Gogs Authors. All rights reserved.
// Use of this source code is governed by a MIT-style
// license that can be found in the LICENSE file.
2016-12-06 20:58:31 +03:00
package templates
2014-04-10 22:20:58 +04:00
import (
2017-03-02 03:25:44 +03:00
"bytes"
2014-04-10 22:20:58 +04:00
"container/list"
"encoding/json"
2017-12-04 02:14:26 +03:00
"errors"
2014-04-10 22:20:58 +04:00
"fmt"
2018-02-27 10:09:18 +03:00
"html"
2014-04-10 22:20:58 +04:00
"html/template"
2016-08-12 02:16:36 +03:00
"mime"
2017-11-28 12:43:51 +03:00
"net/url"
2016-08-12 02:16:36 +03:00
"path/filepath"
2020-11-08 20:21:54 +03:00
"reflect"
2019-11-07 16:34:28 +03:00
"regexp"
2014-05-22 05:37:13 +04:00
"runtime"
2014-04-10 22:20:58 +04:00
"strings"
2019-11-07 16:34:28 +03:00
texttmpl "text/template"
2014-04-10 22:20:58 +04:00
"time"
2019-11-01 07:48:30 +03:00
"unicode"
2014-05-26 04:11:25 +04:00
2016-11-10 19:24:48 +03:00
"code.gitea.io/gitea/models"
"code.gitea.io/gitea/modules/base"
2020-04-28 21:05:39 +03:00
"code.gitea.io/gitea/modules/emoji"
2016-11-10 19:24:48 +03:00
"code.gitea.io/gitea/modules/log"
2017-09-16 20:17:57 +03:00
"code.gitea.io/gitea/modules/markup"
2020-01-10 12:34:21 +03:00
"code.gitea.io/gitea/modules/repository"
2016-11-10 19:24:48 +03:00
"code.gitea.io/gitea/modules/setting"
2020-07-12 12:10:56 +03:00
"code.gitea.io/gitea/modules/svg"
2019-08-15 17:46:21 +03:00
"code.gitea.io/gitea/modules/timeutil"
"code.gitea.io/gitea/modules/util"
2019-09-06 05:20:09 +03:00
"code.gitea.io/gitea/services/gitdiff"
2019-10-01 16:40:17 +03:00
mirror_service "code.gitea.io/gitea/services/mirror"
2017-11-22 10:09:48 +03:00
2019-10-16 00:24:16 +03:00
"github.com/editorconfig/editorconfig-core-go/v2"
2014-04-10 22:20:58 +04:00
)
2019-11-07 16:34:28 +03:00
// Used from static.go && dynamic.go
var mailSubjectSplit = regexp . MustCompile ( ` (?m)^- { 3,}[\s]*$ ` )
2016-11-25 09:23:48 +03:00
// NewFuncMap returns functions for injecting to templates
2016-03-07 00:40:04 +03:00
func NewFuncMap ( ) [ ] template . FuncMap {
return [ ] template . FuncMap { map [ string ] interface { } {
"GoVer" : func ( ) string {
return strings . Title ( runtime . Version ( ) )
} ,
"UseHTTPS" : func ( ) bool {
2016-11-27 13:14:25 +03:00
return strings . HasPrefix ( setting . AppURL , "https" )
2016-03-07 00:40:04 +03:00
} ,
"AppName" : func ( ) string {
return setting . AppName
} ,
"AppSubUrl" : func ( ) string {
2016-11-27 13:14:25 +03:00
return setting . AppSubURL
2016-03-07 00:40:04 +03:00
} ,
2019-10-22 15:11:01 +03:00
"StaticUrlPrefix" : func ( ) string {
return setting . StaticURLPrefix
} ,
2016-03-07 00:40:04 +03:00
"AppUrl" : func ( ) string {
2016-11-27 13:14:25 +03:00
return setting . AppURL
2016-03-07 00:40:04 +03:00
} ,
"AppVer" : func ( ) string {
return setting . AppVer
} ,
2017-02-28 03:40:02 +03:00
"AppBuiltWith" : func ( ) string {
2017-03-01 04:45:21 +03:00
return setting . AppBuiltWith
2017-02-28 03:40:02 +03:00
} ,
2016-03-07 00:40:04 +03:00
"AppDomain" : func ( ) string {
return setting . Domain
} ,
"DisableGravatar" : func ( ) bool {
return setting . DisableGravatar
} ,
2019-05-08 11:41:35 +03:00
"DefaultShowFullName" : func ( ) bool {
return setting . UI . DefaultShowFullName
} ,
2016-09-01 08:01:32 +03:00
"ShowFooterTemplateLoadTime" : func ( ) bool {
return setting . ShowFooterTemplateLoadTime
} ,
2016-03-07 00:40:04 +03:00
"LoadTimes" : func ( startTime time . Time ) string {
return fmt . Sprint ( time . Since ( startTime ) . Nanoseconds ( ) / 1e6 ) + "ms"
} ,
2019-12-28 02:43:56 +03:00
"AllowedReactions" : func ( ) [ ] string {
return setting . UI . Reactions
} ,
2017-12-11 07:37:04 +03:00
"Safe" : Safe ,
"SafeJS" : SafeJS ,
"Str2html" : Str2html ,
2019-08-15 17:46:21 +03:00
"TimeSince" : timeutil . TimeSince ,
"TimeSinceUnix" : timeutil . TimeSinceUnix ,
"RawTimeSince" : timeutil . RawTimeSince ,
2017-12-11 07:37:04 +03:00
"FileSize" : base . FileSize ,
2020-02-03 22:50:37 +03:00
"PrettyNumber" : base . PrettyNumber ,
2017-12-11 07:37:04 +03:00
"Subtract" : base . Subtract ,
2018-05-01 10:04:36 +03:00
"EntryIcon" : base . EntryIcon ,
2019-07-08 05:14:12 +03:00
"MigrationIcon" : MigrationIcon ,
2020-08-06 11:04:08 +03:00
"Add" : func ( a ... int ) int {
sum := 0
for _ , val := range a {
sum += val
}
return sum
} ,
"Mul" : func ( a ... int ) int {
sum := 1
for _ , val := range a {
sum *= val
}
return sum
2016-03-07 00:40:04 +03:00
} ,
"ActionIcon" : ActionIcon ,
"DateFmtLong" : func ( t time . Time ) string {
return t . Format ( time . RFC1123Z )
} ,
"DateFmtShort" : func ( t time . Time ) string {
return t . Format ( "Jan 02, 2006" )
} ,
2020-09-16 07:07:18 +03:00
"SizeFmt" : base . FileSize ,
"CountFmt" : base . FormatNumberSI ,
"List" : List ,
2016-03-07 00:40:04 +03:00
"SubStr" : func ( str string , start , length int ) string {
if len ( str ) == 0 {
return ""
}
end := start + length
if length == - 1 {
end = len ( str )
}
if len ( str ) < end {
return str
}
return str [ start : end ]
} ,
2018-08-29 16:43:58 +03:00
"EllipsisString" : base . EllipsisString ,
"DiffTypeToStr" : DiffTypeToStr ,
"DiffLineTypeToStr" : DiffLineTypeToStr ,
"Sha1" : Sha1 ,
"ShortSha" : base . ShortSha ,
"MD5" : base . EncodeMD5 ,
2016-03-07 00:40:04 +03:00
"ActionContent2Commits" : ActionContent2Commits ,
2017-11-28 12:43:51 +03:00
"PathEscape" : url . PathEscape ,
2016-03-07 00:40:04 +03:00
"EscapePound" : func ( str string ) string {
2016-09-18 18:46:52 +03:00
return strings . NewReplacer ( "%" , "%25" , "#" , "%23" , " " , "%20" , "?" , "%3F" ) . Replace ( str )
2016-03-07 00:40:04 +03:00
} ,
2019-09-10 12:03:30 +03:00
"PathEscapeSegments" : util . PathEscapeSegments ,
"URLJoin" : util . URLJoin ,
"RenderCommitMessage" : RenderCommitMessage ,
"RenderCommitMessageLink" : RenderCommitMessageLink ,
"RenderCommitMessageLinkSubject" : RenderCommitMessageLinkSubject ,
"RenderCommitBody" : RenderCommitBody ,
2020-12-03 13:50:47 +03:00
"RenderIssueTitle" : RenderIssueTitle ,
2020-04-28 21:05:39 +03:00
"RenderEmoji" : RenderEmoji ,
"RenderEmojiPlain" : emoji . ReplaceAliases ,
"ReactionToEmoji" : ReactionToEmoji ,
2019-09-10 12:03:30 +03:00
"RenderNote" : RenderNote ,
"IsMultilineCommitMessage" : IsMultilineCommitMessage ,
2016-03-07 00:40:04 +03:00
"ThemeColorMetaTag" : func ( ) string {
2016-07-23 19:23:54 +03:00
return setting . UI . ThemeColorMetaTag
2016-03-07 00:40:04 +03:00
} ,
2017-04-01 04:03:01 +03:00
"MetaAuthor" : func ( ) string {
return setting . UI . Meta . Author
} ,
"MetaDescription" : func ( ) string {
return setting . UI . Meta . Description
} ,
"MetaKeywords" : func ( ) string {
return setting . UI . Meta . Keywords
} ,
2019-11-21 23:06:23 +03:00
"UseServiceWorker" : func ( ) bool {
return setting . UI . UseServiceWorker
} ,
2016-08-12 02:16:36 +03:00
"FilenameIsImage" : func ( filename string ) bool {
mimeType := mime . TypeByExtension ( filepath . Ext ( filename ) )
return strings . HasPrefix ( mimeType , "image/" )
} ,
2020-07-02 20:33:13 +03:00
"TabSizeClass" : func ( ec interface { } , filename string ) string {
var (
value * editorconfig . Editorconfig
ok bool
)
2016-08-12 03:07:09 +03:00
if ec != nil {
2020-07-02 20:33:13 +03:00
if value , ok = ec . ( * editorconfig . Editorconfig ) ; ! ok || value == nil {
return "tab-size-8"
}
def , err := value . GetDefinitionForFilename ( filename )
2019-10-16 00:24:16 +03:00
if err != nil {
log . Error ( "tab size class: getting definition for filename: %v" , err )
return "tab-size-8"
}
2016-08-12 03:07:09 +03:00
if def . TabWidth > 0 {
return fmt . Sprintf ( "tab-size-%d" , def . TabWidth )
}
}
return "tab-size-8"
} ,
2016-12-28 19:35:52 +03:00
"SubJumpablePath" : func ( str string ) [ ] string {
var path [ ] string
index := strings . LastIndex ( str , "/" )
if index != - 1 && index != len ( str ) {
2019-05-28 18:45:54 +03:00
path = append ( path , str [ 0 : index + 1 ] , str [ index + 1 : ] )
2016-12-28 19:35:52 +03:00
} else {
path = append ( path , str )
}
return path
} ,
2020-11-16 02:50:06 +03:00
"DiffStatsWidth" : func ( adds int , dels int ) string {
return fmt . Sprintf ( "%f" , float64 ( adds ) / ( float64 ( adds ) + float64 ( dels ) ) * 100 )
} ,
2020-01-20 13:07:30 +03:00
"Json" : func ( in interface { } ) string {
out , err := json . Marshal ( in )
if err != nil {
return ""
}
return string ( out )
} ,
2017-03-02 03:25:44 +03:00
"JsonPrettyPrint" : func ( in string ) string {
var out bytes . Buffer
err := json . Indent ( & out , [ ] byte ( in ) , "" , " " )
if err != nil {
return ""
}
return out . String ( )
} ,
2017-09-12 12:25:42 +03:00
"DisableGitHooks" : func ( ) bool {
return setting . DisableGitHooks
} ,
2018-08-24 08:00:22 +03:00
"DisableImportLocal" : func ( ) bool {
return ! setting . ImportLocalPaths
} ,
2017-10-15 02:17:39 +03:00
"TrN" : TrN ,
2017-12-04 02:14:26 +03:00
"Dict" : func ( values ... interface { } ) ( map [ string ] interface { } , error ) {
if len ( values ) % 2 != 0 {
return nil , errors . New ( "invalid dict call" )
}
dict := make ( map [ string ] interface { } , len ( values ) / 2 )
for i := 0 ; i < len ( values ) ; i += 2 {
key , ok := values [ i ] . ( string )
if ! ok {
return nil , errors . New ( "dict keys must be strings" )
}
dict [ key ] = values [ i + 1 ]
}
return dict , nil
} ,
2018-04-29 08:58:47 +03:00
"Printf" : fmt . Sprintf ,
"Escape" : Escape ,
"Sec2Time" : models . SecToTime ,
2018-05-01 22:05:28 +03:00
"ParseDeadline" : func ( deadline string ) [ ] string {
return strings . Split ( deadline , "|" )
} ,
2018-07-06 00:25:04 +03:00
"DefaultTheme" : func ( ) string {
return setting . UI . DefaultTheme
} ,
2020-11-25 14:20:40 +03:00
// pass key-value pairs to a partial template which receives them as a dict
2018-08-06 07:43:22 +03:00
"dict" : func ( values ... interface { } ) ( map [ string ] interface { } , error ) {
if len ( values ) == 0 {
return nil , errors . New ( "invalid dict call" )
}
dict := make ( map [ string ] interface { } )
2020-11-25 14:20:40 +03:00
return util . MergeInto ( dict , values ... )
} ,
/* like dict but merge key-value pairs into the first dict and return it */
"mergeinto" : func ( root map [ string ] interface { } , values ... interface { } ) ( map [ string ] interface { } , error ) {
if len ( values ) == 0 {
return nil , errors . New ( "invalid mergeinto call" )
}
2018-08-06 07:43:22 +03:00
2020-11-25 14:20:40 +03:00
dict := make ( map [ string ] interface { } )
for key , value := range root {
dict [ key ] = value
2018-08-06 07:43:22 +03:00
}
2020-11-25 14:20:40 +03:00
return util . MergeInto ( dict , values ... )
2018-08-06 07:43:22 +03:00
} ,
2019-05-05 19:25:25 +03:00
"percentage" : func ( n int , values ... int ) float32 {
var sum = 0
for i := 0 ; i < len ( values ) ; i ++ {
sum += values [ i ]
}
return float32 ( n ) * 100 / float32 ( sum )
} ,
2019-09-06 05:20:09 +03:00
"CommentMustAsDiff" : gitdiff . CommentMustAsDiff ,
2019-10-01 16:40:17 +03:00
"MirrorAddress" : mirror_service . Address ,
"MirrorFullAddress" : mirror_service . AddressNoCredentials ,
2019-10-09 16:09:02 +03:00
"MirrorUserName" : mirror_service . Username ,
"MirrorPassword" : mirror_service . Password ,
2019-11-02 01:02:41 +03:00
"CommitType" : func ( commit interface { } ) string {
switch commit . ( type ) {
case models . SignCommitWithStatuses :
return "SignCommitWithStatuses"
case models . SignCommit :
return "SignCommit"
case models . UserCommit :
return "UserCommit"
default :
return ""
}
} ,
2020-07-03 12:55:36 +03:00
"NotificationSettings" : func ( ) map [ string ] interface { } {
return map [ string ] interface { } {
2020-05-08 00:49:00 +03:00
"MinTimeout" : int ( setting . UI . Notification . MinTimeout / time . Millisecond ) ,
"TimeoutStep" : int ( setting . UI . Notification . TimeoutStep / time . Millisecond ) ,
"MaxTimeout" : int ( setting . UI . Notification . MaxTimeout / time . Millisecond ) ,
"EventSourceUpdateTime" : int ( setting . UI . Notification . EventSourceUpdateTime / time . Millisecond ) ,
2020-04-24 06:57:38 +03:00
}
} ,
2020-11-08 20:21:54 +03:00
"containGeneric" : func ( arr interface { } , v interface { } ) bool {
arrV := reflect . ValueOf ( arr )
if arrV . Kind ( ) == reflect . String && reflect . ValueOf ( v ) . Kind ( ) == reflect . String {
return strings . Contains ( arr . ( string ) , v . ( string ) )
}
if arrV . Kind ( ) == reflect . Slice {
for i := 0 ; i < arrV . Len ( ) ; i ++ {
iV := arrV . Index ( i )
if ! iV . CanInterface ( ) {
continue
}
if iV . Interface ( ) == v {
return true
}
}
}
return false
} ,
2019-12-28 17:43:46 +03:00
"contain" : func ( s [ ] int64 , id int64 ) bool {
for i := 0 ; i < len ( s ) ; i ++ {
if s [ i ] == id {
return true
}
}
return false
} ,
2020-12-03 21:46:11 +03:00
"svg" : SVG ,
"avatar" : Avatar ,
"avatarByEmail" : AvatarByEmail ,
2020-06-25 01:23:05 +03:00
"SortArrow" : func ( normSort , revSort , urlSort string , isDefault bool ) template . HTML {
// if needed
if len ( normSort ) == 0 || len ( urlSort ) == 0 {
return ""
}
if len ( urlSort ) == 0 && isDefault {
// if sort is sorted as default add arrow tho this table header
if isDefault {
return SVG ( "octicon-triangle-down" , 16 )
}
} else {
// if sort arg is in url test if it correlates with column header sort arguments
if urlSort == normSort {
// the table is sorted with this header normal
return SVG ( "octicon-triangle-down" , 16 )
} else if urlSort == revSort {
// the table is sorted with this header reverse
return SVG ( "octicon-triangle-up" , 16 )
}
}
// the table is NOT sorted with this header
return ""
2020-02-11 20:02:41 +03:00
} ,
2020-10-26 00:49:48 +03:00
"RenderLabels" : func ( labels [ ] * models . Label ) template . HTML {
2020-11-29 06:26:03 +03:00
html := ` <span class="labels-list"> `
2020-10-26 00:49:48 +03:00
for _ , label := range labels {
2020-11-29 06:26:03 +03:00
html += fmt . Sprintf ( "<div class='ui label' style='color: %s; background-color: %s'>%s</div>" ,
label . ForegroundColor ( ) , label . Color , RenderEmoji ( label . Name ) )
2020-10-26 00:49:48 +03:00
}
2020-11-29 06:26:03 +03:00
html += "</span>"
2020-10-26 00:49:48 +03:00
return template . HTML ( html )
} ,
2016-03-07 00:40:04 +03:00
} }
2015-11-14 06:45:33 +03:00
}
2019-11-07 16:34:28 +03:00
// NewTextFuncMap returns functions for injecting to text templates
// It's a subset of those used for HTML and other templates
func NewTextFuncMap ( ) [ ] texttmpl . FuncMap {
return [ ] texttmpl . FuncMap { map [ string ] interface { } {
"GoVer" : func ( ) string {
return strings . Title ( runtime . Version ( ) )
} ,
"AppName" : func ( ) string {
return setting . AppName
} ,
"AppSubUrl" : func ( ) string {
return setting . AppSubURL
} ,
"AppUrl" : func ( ) string {
return setting . AppURL
} ,
"AppVer" : func ( ) string {
return setting . AppVer
} ,
"AppBuiltWith" : func ( ) string {
return setting . AppBuiltWith
} ,
"AppDomain" : func ( ) string {
return setting . Domain
} ,
"TimeSince" : timeutil . TimeSince ,
"TimeSinceUnix" : timeutil . TimeSinceUnix ,
"RawTimeSince" : timeutil . RawTimeSince ,
"DateFmtLong" : func ( t time . Time ) string {
return t . Format ( time . RFC1123Z )
} ,
"DateFmtShort" : func ( t time . Time ) string {
return t . Format ( "Jan 02, 2006" )
} ,
"List" : List ,
"SubStr" : func ( str string , start , length int ) string {
if len ( str ) == 0 {
return ""
}
end := start + length
if length == - 1 {
end = len ( str )
}
if len ( str ) < end {
return str
}
return str [ start : end ]
} ,
"EllipsisString" : base . EllipsisString ,
"URLJoin" : util . URLJoin ,
"Dict" : func ( values ... interface { } ) ( map [ string ] interface { } , error ) {
if len ( values ) % 2 != 0 {
return nil , errors . New ( "invalid dict call" )
}
dict := make ( map [ string ] interface { } , len ( values ) / 2 )
for i := 0 ; i < len ( values ) ; i += 2 {
key , ok := values [ i ] . ( string )
if ! ok {
return nil , errors . New ( "dict keys must be strings" )
}
dict [ key ] = values [ i + 1 ]
}
return dict , nil
} ,
"Printf" : fmt . Sprintf ,
"Escape" : Escape ,
"Sec2Time" : models . SecToTime ,
"ParseDeadline" : func ( deadline string ) [ ] string {
return strings . Split ( deadline , "|" )
} ,
"dict" : func ( values ... interface { } ) ( map [ string ] interface { } , error ) {
if len ( values ) == 0 {
return nil , errors . New ( "invalid dict call" )
}
dict := make ( map [ string ] interface { } )
for i := 0 ; i < len ( values ) ; i ++ {
switch key := values [ i ] . ( type ) {
case string :
i ++
if i == len ( values ) {
return nil , errors . New ( "specify the key for non array values" )
}
dict [ key ] = values [ i ]
case map [ string ] interface { } :
m := values [ i ] . ( map [ string ] interface { } )
for i , v := range m {
dict [ i ] = v
}
default :
return nil , errors . New ( "dict values must be maps" )
}
}
return dict , nil
} ,
"percentage" : func ( n int , values ... int ) float32 {
var sum = 0
for i := 0 ; i < len ( values ) ; i ++ {
sum += values [ i ]
}
return float32 ( n ) * 100 / float32 ( sum )
} ,
2020-08-06 11:04:08 +03:00
"Add" : func ( a ... int ) int {
sum := 0
for _ , val := range a {
sum += val
}
return sum
} ,
"Mul" : func ( a ... int ) int {
sum := 1
for _ , val := range a {
sum *= val
}
return sum
} ,
2019-11-07 16:34:28 +03:00
} }
}
2020-07-12 12:10:56 +03:00
var widthRe = regexp . MustCompile ( ` width="[0-9]+?" ` )
var heightRe = regexp . MustCompile ( ` height="[0-9]+?" ` )
2020-12-03 21:46:11 +03:00
func parseOthers ( defaultSize int , defaultClass string , others ... interface { } ) ( int , string ) {
size := defaultSize
2020-09-11 23:19:00 +03:00
if len ( others ) > 0 && others [ 0 ] . ( int ) != 0 {
size = others [ 0 ] . ( int )
}
2020-09-08 20:17:56 +03:00
2020-12-03 21:46:11 +03:00
class := defaultClass
2020-09-08 20:17:56 +03:00
if len ( others ) > 1 && others [ 1 ] . ( string ) != "" {
2020-12-03 21:46:11 +03:00
if defaultClass == "" {
class = others [ 1 ] . ( string )
} else {
class = defaultClass + " " + others [ 1 ] . ( string )
}
}
return size , class
}
func avatarHTML ( src string , size int , class string , name string ) template . HTML {
sizeStr := fmt . Sprintf ( ` %d ` , size )
if name == "" {
name = "avatar"
2020-09-08 20:17:56 +03:00
}
2020-12-03 21:46:11 +03:00
return template . HTML ( ` <img class=" ` + class + ` " src=" ` + src + ` " title=" ` + html . EscapeString ( name ) + ` " width=" ` + sizeStr + ` " height=" ` + sizeStr + ` "/> ` )
}
// SVG render icons - arguments icon name (string), size (int), class (string)
func SVG ( icon string , others ... interface { } ) template . HTML {
size , class := parseOthers ( 16 , "" , others ... )
2020-07-12 12:10:56 +03:00
if svgStr , ok := svg . SVGs [ icon ] ; ok {
if size != 16 {
svgStr = widthRe . ReplaceAllString ( svgStr , fmt . Sprintf ( ` width="%d" ` , size ) )
svgStr = heightRe . ReplaceAllString ( svgStr , fmt . Sprintf ( ` height="%d" ` , size ) )
}
2020-09-08 20:17:56 +03:00
if class != "" {
svgStr = strings . Replace ( svgStr , ` class=" ` , fmt . Sprintf ( ` class="%s ` , class ) , 1 )
}
2020-07-12 12:10:56 +03:00
return template . HTML ( svgStr )
}
return template . HTML ( "" )
2020-06-25 01:23:05 +03:00
}
2020-12-03 21:46:11 +03:00
// Avatar renders user and repo avatars. args: user/repo, size (int), class (string)
func Avatar ( item interface { } , others ... interface { } ) template . HTML {
size , class := parseOthers ( 28 , "ui avatar image" , others ... )
if user , ok := item . ( * models . User ) ; ok {
src := user . RealSizedAvatarLink ( size * 2 ) // request double size for finer rendering
if src != "" {
return avatarHTML ( src , size , class , user . DisplayName ( ) )
}
}
if repo , ok := item . ( * models . Repository ) ; ok {
src := repo . RelAvatarLink ( )
if src != "" {
return avatarHTML ( src , size , class , repo . FullName ( ) )
}
}
return template . HTML ( "" )
}
// AvatarByEmail renders avatars by email address. args: email, name, size (int), class (string)
func AvatarByEmail ( email string , name string , others ... interface { } ) template . HTML {
size , class := parseOthers ( 28 , "ui avatar image" , others ... )
src := models . SizedAvatarLink ( email , size * 2 ) // request double size for finer rendering
if src != "" {
return avatarHTML ( src , size , class , name )
}
return template . HTML ( "" )
}
2016-11-25 09:23:48 +03:00
// Safe render raw as HTML
2015-08-08 12:10:34 +03:00
func Safe ( raw string ) template . HTML {
return template . HTML ( raw )
}
2017-08-23 17:58:05 +03:00
// SafeJS renders raw as JS
func SafeJS ( raw string ) template . JS {
return template . JS ( raw )
}
2016-11-25 09:23:48 +03:00
// Str2html render Markdown text to HTML
2014-04-10 22:20:58 +04:00
func Str2html ( raw string ) template . HTML {
2017-09-16 20:17:57 +03:00
return template . HTML ( markup . Sanitize ( raw ) )
2014-04-10 22:20:58 +04:00
}
2018-02-11 16:42:28 +03:00
// Escape escapes a HTML string
func Escape ( raw string ) string {
return html . EscapeString ( raw )
}
2016-11-25 09:23:48 +03:00
// List traversings the list
2014-04-10 22:20:58 +04:00
func List ( l * list . List ) chan interface { } {
e := l . Front ( )
c := make ( chan interface { } )
go func ( ) {
for e != nil {
c <- e . Value
e = e . Next ( )
}
close ( c )
} ( )
return c
}
2016-11-25 09:23:48 +03:00
// Sha1 returns sha1 sum of string
2015-02-19 00:52:22 +03:00
func Sha1 ( str string ) string {
2015-11-14 01:10:25 +03:00
return base . EncodeSha1 ( str )
2014-12-09 10:18:25 +03:00
}
2015-01-31 02:05:20 +03:00
// RenderCommitMessage renders commit message with XSS-safe and special links.
2017-11-13 04:35:55 +03:00
func RenderCommitMessage ( msg , urlPrefix string , metas map [ string ] string ) template . HTML {
2018-02-27 10:09:18 +03:00
return RenderCommitMessageLink ( msg , urlPrefix , "" , metas )
2017-11-13 04:35:55 +03:00
}
// RenderCommitMessageLink renders commit message as a XXS-safe link to the provided
// default url, handling for special links.
2018-02-27 10:09:18 +03:00
func RenderCommitMessageLink ( msg , urlPrefix , urlDefault string , metas map [ string ] string ) template . HTML {
2015-09-19 04:57:06 +03:00
cleanMsg := template . HTMLEscapeString ( msg )
2018-02-27 10:09:18 +03:00
// we can safely assume that it will not return any error, since there
// shouldn't be any special HTML.
fullMessage , err := markup . RenderCommitMessage ( [ ] byte ( cleanMsg ) , urlPrefix , urlDefault , metas )
if err != nil {
2019-04-02 10:48:31 +03:00
log . Error ( "RenderCommitMessage: %v" , err )
2018-02-27 10:09:18 +03:00
return ""
}
msgLines := strings . Split ( strings . TrimSpace ( string ( fullMessage ) ) , "\n" )
2017-11-13 04:35:55 +03:00
if len ( msgLines ) == 0 {
2015-12-07 02:18:12 +03:00
return template . HTML ( "" )
2015-09-19 04:57:06 +03:00
}
2017-11-13 04:35:55 +03:00
return template . HTML ( msgLines [ 0 ] )
2015-01-31 02:05:20 +03:00
}
2019-09-10 12:03:30 +03:00
// RenderCommitMessageLinkSubject renders commit message as a XXS-safe link to
// the provided default url, handling for special links without email to links.
func RenderCommitMessageLinkSubject ( msg , urlPrefix , urlDefault string , metas map [ string ] string ) template . HTML {
2019-11-01 07:48:30 +03:00
msgLine := strings . TrimLeftFunc ( msg , unicode . IsSpace )
lineEnd := strings . IndexByte ( msgLine , '\n' )
if lineEnd > 0 {
msgLine = msgLine [ : lineEnd ]
}
msgLine = strings . TrimRightFunc ( msgLine , unicode . IsSpace )
if len ( msgLine ) == 0 {
return template . HTML ( "" )
}
2019-09-10 12:03:30 +03:00
// we can safely assume that it will not return any error, since there
// shouldn't be any special HTML.
2019-11-01 07:48:30 +03:00
renderedMessage , err := markup . RenderCommitMessageSubject ( [ ] byte ( template . HTMLEscapeString ( msgLine ) ) , urlPrefix , urlDefault , metas )
2019-09-10 12:03:30 +03:00
if err != nil {
log . Error ( "RenderCommitMessageSubject: %v" , err )
return template . HTML ( "" )
}
2019-11-01 07:48:30 +03:00
return template . HTML ( renderedMessage )
2019-09-10 12:03:30 +03:00
}
2017-11-30 08:08:40 +03:00
// RenderCommitBody extracts the body of a commit message without its title.
func RenderCommitBody ( msg , urlPrefix string , metas map [ string ] string ) template . HTML {
2019-11-01 07:48:30 +03:00
msgLine := strings . TrimRightFunc ( msg , unicode . IsSpace )
lineEnd := strings . IndexByte ( msgLine , '\n' )
if lineEnd > 0 {
msgLine = msgLine [ lineEnd + 1 : ]
} else {
return template . HTML ( "" )
}
msgLine = strings . TrimLeftFunc ( msgLine , unicode . IsSpace )
if len ( msgLine ) == 0 {
return template . HTML ( "" )
}
renderedMessage , err := markup . RenderCommitMessage ( [ ] byte ( template . HTMLEscapeString ( msgLine ) ) , urlPrefix , "" , metas )
2018-02-27 10:09:18 +03:00
if err != nil {
2019-04-02 10:48:31 +03:00
log . Error ( "RenderCommitMessage: %v" , err )
2018-02-27 10:09:18 +03:00
return ""
}
2019-11-01 07:48:30 +03:00
return template . HTML ( renderedMessage )
2017-11-30 08:08:40 +03:00
}
2020-12-03 13:50:47 +03:00
// RenderIssueTitle renders issue/pull title with defined post processors
func RenderIssueTitle ( text , urlPrefix string , metas map [ string ] string ) template . HTML {
renderedText , err := markup . RenderIssueTitle ( [ ] byte ( template . HTMLEscapeString ( text ) ) , urlPrefix , metas )
if err != nil {
log . Error ( "RenderIssueTitle: %v" , err )
return template . HTML ( "" )
}
return template . HTML ( renderedText )
}
2020-04-28 21:05:39 +03:00
// RenderEmoji renders html text with emoji post processors
func RenderEmoji ( text string ) template . HTML {
renderedText , err := markup . RenderEmoji ( [ ] byte ( template . HTMLEscapeString ( text ) ) )
if err != nil {
log . Error ( "RenderEmoji: %v" , err )
return template . HTML ( "" )
}
return template . HTML ( renderedText )
}
//ReactionToEmoji renders emoji for use in reactions
func ReactionToEmoji ( reaction string ) template . HTML {
val := emoji . FromCode ( reaction )
if val != nil {
return template . HTML ( val . Emoji )
}
val = emoji . FromAlias ( reaction )
if val != nil {
return template . HTML ( val . Emoji )
}
2020-08-24 04:44:53 +03:00
return template . HTML ( fmt . Sprintf ( ` <img alt=":%s:" src="%s/img/emoji/%s.png"></img> ` , reaction , setting . StaticURLPrefix , reaction ) )
2020-04-28 21:05:39 +03:00
}
2019-05-24 10:52:05 +03:00
// RenderNote renders the contents of a git-notes file as a commit message.
func RenderNote ( msg , urlPrefix string , metas map [ string ] string ) template . HTML {
cleanMsg := template . HTMLEscapeString ( msg )
fullMessage , err := markup . RenderCommitMessage ( [ ] byte ( cleanMsg ) , urlPrefix , "" , metas )
if err != nil {
log . Error ( "RenderNote: %v" , err )
return ""
}
return template . HTML ( string ( fullMessage ) )
}
2017-11-30 08:08:40 +03:00
// IsMultilineCommitMessage checks to see if a commit message contains multiple lines.
func IsMultilineCommitMessage ( msg string ) bool {
2018-06-15 17:07:48 +03:00
return strings . Count ( strings . TrimSpace ( msg ) , "\n" ) >= 1
2017-11-30 08:08:40 +03:00
}
2016-11-25 09:23:48 +03:00
// Actioner describes an action
2014-04-10 22:20:58 +04:00
type Actioner interface {
2017-09-20 04:22:42 +03:00
GetOpType ( ) models . ActionType
2014-04-10 22:20:58 +04:00
GetActUserName ( ) string
2014-05-09 10:42:50 +04:00
GetRepoUserName ( ) string
2014-04-10 22:20:58 +04:00
GetRepoName ( ) string
2015-09-01 16:29:52 +03:00
GetRepoPath ( ) string
GetRepoLink ( ) string
2014-04-10 22:20:58 +04:00
GetBranch ( ) string
GetContent ( ) string
2015-09-01 16:29:52 +03:00
GetCreate ( ) time . Time
GetIssueInfos ( ) [ ] string
2014-04-10 22:20:58 +04:00
}
2017-09-20 04:22:42 +03:00
// ActionIcon accepts an action operation type and returns an icon class name.
func ActionIcon ( opType models . ActionType ) string {
2014-04-10 22:20:58 +04:00
switch opType {
2017-09-20 04:22:42 +03:00
case models . ActionCreateRepo , models . ActionTransferRepo :
2014-07-26 08:24:27 +04:00
return "repo"
2017-09-21 10:43:26 +03:00
case models . ActionCommitRepo , models . ActionPushTag , models . ActionDeleteTag , models . ActionDeleteBranch :
2014-07-26 08:24:27 +04:00
return "git-commit"
2017-09-20 04:22:42 +03:00
case models . ActionCreateIssue :
2014-07-26 08:24:27 +04:00
return "issue-opened"
2017-09-20 04:22:42 +03:00
case models . ActionCreatePullRequest :
2015-11-16 19:39:48 +03:00
return "git-pull-request"
2019-12-22 11:29:26 +03:00
case models . ActionCommentIssue , models . ActionCommentPull :
2016-07-16 07:45:13 +03:00
return "comment-discussion"
2017-09-20 04:22:42 +03:00
case models . ActionMergePullRequest :
2015-11-16 19:39:48 +03:00
return "git-merge"
2017-09-20 04:22:42 +03:00
case models . ActionCloseIssue , models . ActionClosePullRequest :
2016-02-22 20:40:00 +03:00
return "issue-closed"
2017-09-20 04:22:42 +03:00
case models . ActionReopenIssue , models . ActionReopenPullRequest :
2016-03-05 20:58:51 +03:00
return "issue-reopened"
2018-09-07 05:06:09 +03:00
case models . ActionMirrorSyncPush , models . ActionMirrorSyncCreate , models . ActionMirrorSyncDelete :
return "repo-clone"
2019-11-15 02:52:18 +03:00
case models . ActionApprovePullRequest :
2020-04-24 07:58:14 +03:00
return "check"
2019-11-15 02:52:18 +03:00
case models . ActionRejectPullRequest :
2020-07-17 18:15:12 +03:00
return "diff"
2020-07-29 22:20:54 +03:00
case models . ActionPublishRelease :
return "tag"
2014-04-10 22:20:58 +04:00
default :
2020-04-24 07:58:14 +03:00
return "question"
2014-04-10 22:20:58 +04:00
}
}
2016-11-25 09:23:48 +03:00
// ActionContent2Commits converts action content to push commits
2020-01-10 12:34:21 +03:00
func ActionContent2Commits ( act Actioner ) * repository . PushCommits {
push := repository . NewPushCommits ( )
2015-11-14 01:10:25 +03:00
if err := json . Unmarshal ( [ ] byte ( act . GetContent ( ) ) , push ) ; err != nil {
2019-04-02 10:48:31 +03:00
log . Error ( "json.Unmarshal:\n%s\nERROR: %v" , act . GetContent ( ) , err )
2014-07-26 08:24:27 +04:00
}
return push
}
2016-11-25 09:23:48 +03:00
// DiffTypeToStr returns diff type name
2014-04-10 22:20:58 +04:00
func DiffTypeToStr ( diffType int ) string {
diffTypes := map [ int ] string {
2020-09-09 16:08:40 +03:00
1 : "add" , 2 : "modify" , 3 : "del" , 4 : "rename" , 5 : "copy" ,
2014-04-10 22:20:58 +04:00
}
return diffTypes [ diffType ]
}
2016-11-25 09:23:48 +03:00
// DiffLineTypeToStr returns diff line type name
2014-04-10 22:20:58 +04:00
func DiffLineTypeToStr ( diffType int ) string {
switch diffType {
case 2 :
return "add"
case 3 :
return "del"
case 4 :
return "tag"
}
return "same"
}
2017-10-15 02:17:39 +03:00
// Language specific rules for translating plural texts
var trNLangRules = map [ string ] func ( int64 ) int {
"en-US" : func ( cnt int64 ) int {
if cnt == 1 {
return 0
}
return 1
} ,
"lv-LV" : func ( cnt int64 ) int {
if cnt % 10 == 1 && cnt % 100 != 11 {
return 0
}
return 1
} ,
"ru-RU" : func ( cnt int64 ) int {
if cnt % 10 == 1 && cnt % 100 != 11 {
return 0
}
return 1
} ,
"zh-CN" : func ( cnt int64 ) int {
return 0
} ,
"zh-HK" : func ( cnt int64 ) int {
return 0
} ,
"zh-TW" : func ( cnt int64 ) int {
return 0
} ,
2019-05-05 01:44:43 +03:00
"fr-FR" : func ( cnt int64 ) int {
if cnt > - 2 && cnt < 2 {
return 0
}
return 1
} ,
2017-10-15 02:17:39 +03:00
}
// TrN returns key to be used for plural text translation
func TrN ( lang string , cnt interface { } , key1 , keyN string ) string {
var c int64
if t , ok := cnt . ( int ) ; ok {
c = int64 ( t )
} else if t , ok := cnt . ( int16 ) ; ok {
c = int64 ( t )
} else if t , ok := cnt . ( int32 ) ; ok {
c = int64 ( t )
} else if t , ok := cnt . ( int64 ) ; ok {
c = t
} else {
return keyN
}
ruleFunc , ok := trNLangRules [ lang ]
if ! ok {
ruleFunc = trNLangRules [ "en-US" ]
}
if ruleFunc ( c ) == 0 {
return key1
}
return keyN
}
2019-07-08 05:14:12 +03:00
// MigrationIcon returns a Font Awesome name matching the service an issue/comment was migrated from
func MigrationIcon ( hostname string ) string {
switch hostname {
case "github.com" :
return "fa-github"
default :
return "fa-git-alt"
}
}
2019-11-07 16:34:28 +03:00
func buildSubjectBodyTemplate ( stpl * texttmpl . Template , btpl * template . Template , name string , content [ ] byte ) {
// Split template into subject and body
var subjectContent [ ] byte
bodyContent := content
loc := mailSubjectSplit . FindIndex ( content )
if loc != nil {
subjectContent = content [ 0 : loc [ 0 ] ]
bodyContent = content [ loc [ 1 ] : ]
}
if _ , err := stpl . New ( name ) .
Parse ( string ( subjectContent ) ) ; err != nil {
log . Warn ( "Failed to parse template [%s/subject]: %v" , name , err )
}
if _ , err := btpl . New ( name ) .
Parse ( string ( bodyContent ) ) ; err != nil {
log . Warn ( "Failed to parse template [%s/body]: %v" , name , err )
}
}