plet

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #llm #golang #android #machine-learning #linux #docker #macos #cli #pytorch #security

(★ 9)

Plet is a template package for web apps that wraps html/template

plet Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Go Report Card](https://goreportcard.com/badge/github.com/steven-ferrer/plet)](https://goreportcard.com/report/github.com/steven-ferrer/plet) [![godocs](https://godoc.org/github.com/steven-ferrer/plet?status.svg)](https://godoc.org/github.com/steven-ferrer/plet)

## Plet

Plet is a simple template package for web apps. Plet wraps `html/template` and provides helper functions.

## Terminologies

__Layout__: layout templates serves as base for content templates.

__Content__: content templates is where you define the sections of your templates.

## Basic Usage

### layout template

[tmplt/layout/basic/basic.html](https://github.com/steven-ferrer/plet/blob/master/examples/tmplt/layout/basic/basic.html): layout template. Note that for layout templates, folder name must match the template declaration.

```html
{{ define "basic" }}
<!DOCTYPE html>
<html lang="en">
	<head>
		<meta charset="UTF-8">
		<meta name="viewport" content="width=device-width, initial-scale=1">
		{{ template "head" . }}
	</head>
	<body>
		{{ template "content" . }}

{{ template "foot" . }}
	</body>
</html>
{{ end }}
```
	
### content templates
	
[tmplt/content/simple/head.html](https://github.com/steven-ferrer/plet/blob/master/examples/tmplt/content/simple/head.html)
	
	{{ define "head" }}
	<title>Plet | Template Management Package</title>
	{{ end }}

[tmplt/content/simple/content.html](https://github.com/steven-ferrer/plet/blob/master/examples/tmplt/content/simple/content.html)

```html
{{ define "content" }}
<h1>Hello World!</h1>
{{ end }}
```

[tmplt/content/simple/foot.html](https://github.com/steven-ferrer/plet/blob/master/examples/tmplt/content/simple/foot.html)

```html
{{ define "foot" }}
<p>Hello, I'm a footer!</p>
{{end}}
```

[basic.go](https://github.com/steven-ferrer/plet/blob/master/examples/basic.go):

```go
import (
	"log"
	"os"

"github.com/steven-ferrer/plet"
)

const (
	contentDir = "tmplt/content/"
	layoutDir  = "tmplt/layout/"
)

//very simple example of using plet package
func main() {
	//new template
	t := plet.New(contentDir+"simple", layoutDir+"basic")

//initialize template, this will compile the template
	err := t.Init()
	if err != nil {
		log.Fatal(err)
	}

err = t.Execute(os.Stdout, nil)
	if err != nil {
		log.Fatal(err)
	}
}
```

## More Examples

For more examples please see [examples](https://github.com/steven-ferrer/plet/tree/master/examples) folder.

## Issues and Question

If you found a bug or have a question, please feel free to open an issue.

## Contributing

Please feel free to contribute by submitting a PR.

plet

plet Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

plet

plet Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README