Coder Social home page Coder Social logo

gohugoio / hugo Goto Github PK

View Code? Open in Web Editor NEW
73.1K 73.1K 7.3K 119.39 MB

The world’s fastest framework for building websites.

Home Page: https://gohugo.io

License: Apache License 2.0

Go 95.84% Shell 0.06% HTML 0.95% Dockerfile 0.02% CSS 0.01% JavaScript 3.13%
blog-engine cms content-management-system documentation-tool go hugo static-site-generator

hugo's People

Contributors

abh avatar alexandear avatar anthonyfok avatar bep avatar coliff avatar deining avatar dependabot[bot] avatar digitalcraftsman avatar halostatue avatar jmooring avatar k4rtik avatar markdblackwell avatar mdhender avatar mohae avatar moorereason avatar n10v avatar natefinch avatar niklasfasching avatar noahcampbell avatar onedrawingperday avatar owenwaller avatar rickcogley avatar robertbasic avatar satotake avatar schumacherfm avatar spf13 avatar tatsushid avatar vangent avatar vassudanagunta avatar vbatoufflet avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

hugo's Issues

build failure

tried rebuilding the normal way, got an import failure for toml

mjt:goprojects mikejt$ go get github.com/spf13/hugo
# github.com/spf13/hugo/hugolib
src/github.com/spf13/hugo/hugolib/config.go:19: import /Users/mikejt/goprojects/pkg/darwin_amd64/github.com/BurntSushi/toml.a: object is [darwin amd64 go1.1.1 X:none] expected [darwin amd64 go1.1.2 X:none]

External dependencies missing when building Hugo !?

Quote from the main page :
Hugo has no external dependencies.

But when trying to build the project :

    pi@raspberrypi ~/projects/go/src/github.com/hugo $ go build -o hugo main.go
    hugolib/site.go:17:2: cannot find package "bitbucket.org/pkg/inflect" in any of:
            /home/pi/bin/go/src/pkg/bitbucket.org/pkg/inflect (from $GOROOT)
            /home/pi/projects/go/src/bitbucket.org/pkg/inflect (from $GOPATH)
    hugolib/page.go:20:2: cannot find package "github.com/BurntSushi/toml" in any of:
            /home/pi/bin/go/src/pkg/github.com/BurntSushi/toml (from $GOROOT)
            /home/pi/projects/go/src/github.com/BurntSushi/toml (from $GOPATH)
    hugolib/helpers.go:19:2: cannot find package "github.com/kr/pretty" in any of:
            /home/pi/bin/go/src/pkg/github.com/kr/pretty (from $GOROOT)
            /home/pi/projects/go/src/github.com/kr/pretty (from $GOPATH)
    hugolib/page.go:21:2: cannot find package "github.com/theplant/blackfriday" in any of:
            /home/pi/bin/go/src/pkg/github.com/theplant/blackfriday (from $GOROOT)
            /home/pi/projects/go/src/github.com/theplant/blackfriday (from $GOPATH)
    hugolib/config.go:17:2: cannot find package "launchpad.net/goyaml" in any of:
            /home/pi/bin/go/src/pkg/launchpad.net/goyaml (from $GOROOT)
            /home/pi/projects/go/src/launchpad.net/goyaml (from $GOPATH)

RSS broken

New transformer functionality inserts extra ...

To all xml output.

index values should be any string

right now it appears that any index type I create has the values in the front matter turned into lower case, e.g.: 'taskgroup: [ "TSN" ]' gets turned into the index value of "tsn" ... also, I'd like to have index "names" that are independent of the filenames so that I can have an index name of "Task Group" for the above case when I'm rendering an index page or otherwise using the list (I know I can do that explicitly, but it would be nice to have all the descriptive data associated with an index/menu/list in one place and available for use in a template.

Add post hook on site generation

I would find it useful to have a post hook after the site is generated, especially with the watch functionality where the site is generated on every change (which is very useful!). for example, a script could open or refresh a browser window or call sync files, etc.

question ... top level pages?

how do I do top level pages? there are comments in the commits that mention this, but it's not obvious how to do it. I tried creating an index.md at the top level of /contents, but then hugo asks for indexes/index.md.html

BUG lost top level index.html

The index.html at the top level of layouts is not being rendered ... as a result, the docs example will not be generated correctly ,,,

Indexes documentation is missing

Hi Steve,

I tried to setup a blog with Hugo and hit a wall when trying to understand how indexes work (for example, to render a page with posts).

The docs are missing (at least, on hugo.spf13.com). I have not yet tried to look at the code.

Could you please add something to the docs about indexes?

BlackFriday: new autolink behavior breaks some shortcodes

BlackFriday committed a change this morning which automatically converts URLs found in markdown content to HTML links.

I have a shortcode that takes a "src" parameter as a full URL, but the ShortcodesHandle func is getting the autolinked input rather than the raw URL:

expected values for "name" and "par" in ShortcodesHandle are:

name: embed
par: src=“https://example.com/"

as of this morning, it is now getting:

name:  embed
par:  src=&ldquo;<a href="https://example.com/&quot;">https://example.com/&quot;</a>

Here's the change that appears to cause the issue:
"make autolink peforms like GFM"
theplant/blackfriday@16c09b0

I can work around the issue by using a partial URL as the parameter, but this should be fixed (or documented).

Front matter page in documentation is inconsistent and difficult to understand

The Front matter page lists four variables as required: title, description, date and indexes.

However, YAML example has pubdate and no date.

In addition, the phrasing of "indexes" is very vague. I read the line about indexes several times and did not realize it refers to multiple keys instead of just one. In fact, only when I started to write this bug report I figured out how they work.

Controlling ordering of pages

Hi, I' using Hugo for generating documentation pages, and I'd like to generate a table of contents where the links to the different pages are ordered by either the filename, or possibly an attribute given in the front matter. I've read the docs on indexes but I can't see anything about how to control the ordering of an individual index, is it possible?

Add Mustache template support

Mustache is langugage independent template system. If you implement mustache support I think more people migrated from other static site generators.

Thanks,

Inconsistent documentation on aliases

The example provided


---
aliases:
    - /posts/my-original-url/
    - /2010/even-earlier-url.html

---

then states (emphasis mine)

"You Need to provide a relative path and the complete filename or directory."

Should it say absolute path instead since the path is absolute to the perspective of the web root.

Add documentation about the <!--more--> tag

I went to add some documentation about the

 tag in the docs but couldn't build the docs from the docs directory:

hugo --server
Error rendering site: Layout not found
Available templates:    
    alias
    alias-xhtml
    _default/single.html
    chrome/footer.html
    chrome/header.html
    chrome/includes.html
    chrome/menu.html
    index.html
Layout not found
Web Server is available at http://localhost:1313
Press ctrl+c to stop

hugo/doc does not build

I can't build the hugo documentation site with hugo ... hugo builds fine, but I get a:
"— Error rendering site: html/template: "indexes/layout.html" is undefined" message ..

Question/request about Url: in front matter

When specifying the url in the front matter I would like to have a non ugly url:

url: "mycategory/myarticle-about-whatever"

However, the file it generates:

mycategory/myarticle-about-whatever

Expected:

mycategory/myarticle-about-whatever/index.html

Specifying the url like this works however the permalink uses an ugly url:

url: "mycategory/myarticle-about-whatever/index.html"

Add support for generating a sitemap.xml

A sitemap.xml file can be used to help influence how crawlers index your site.

I imagine this could be implemented in a very similar fashion to the current rss.xml support. Maybe all .html and .xml (and possibly .atom) files in layouts should be rendered? Or all plain files in layouts?

Error rendering site: Layout not found

The latest version of hugo (71678a7) fails to build the included docs with the following error:

Error rendering site: Layout not found
Available templates:
alias-xhtml
_default/single.html
chrome/footer.html
chrome/includes.html
extras/single.html
alias
chrome/header.html
chrome/menu.html
index.html
Layout not found

I'm using go1.1.2 linux/amd64 on Arch.

forum or discussion?

this is not an issue for the repo per se, but I would love a place to ask usage questions about hugo. Doesn't have to be a full blown forum but some kind of discussion might be nice. Alternatively, a few more test example sites to show off some of the features might be helpful.

thanks for this project, hugo is incredibly fast and really enjoying using it so far.

Support for preprocessors

There should be some support for HTML/CSS/JS preprocessors even if it's just adding shell commands to run in the config.

More documentation on indexes ?

The project looks nice but I find the doc on indexes quite obscure. It would be great to add a working example using tags. Also, I don't understand the necessity of the singular/plural naming of indexes.

Site generated with 0-byte files on Windows

I downloaded https://github.com/spf13/hugo/releases/download/v0.8/hugo-windows-amd64, renamed to hugo.exe and ran it against the docs directory and it apparently ran successfully:

C:\Temp\hugo>hugo -v
doc\index.html
index.html
doc\configuration/index.html
doc\contributing/index.html
doc\contributors/index.html
doc\example/index.html
doc\front-matter/index.html
doc\indexes/index.html
doc\installing/index.html
doc\license/index.html
doc\organization/index.html
doc\release-notes/index.html
doc\roadmap/index.html
doc\shortcodes/index.html
doc\source-directory/index.html
doc\templates/index.html
doc\usage/index.html
doc\variables/index.html
16 pages created
0 tags created
0 categories created
in 66 ms

But all of the HTML files generated under public are 0-byte files.

Same result with the 32-bit 386 version. Also 0-byte files with --uglyurls=true

This is running on Windows 7 x64.

Date field does not support times?

I have several posts on a single day. To sort them correctly, I use the following date format:
2010-05-02 15:29:31+08:00

However, when I try to print the date, I will only get the following:
0001-01-01 00:00:00 +0000 UTC

Expected result is that the timestamp is handled correctly

Another release

Just wanted to suggest making a new release sometime soon. It seems like a lot of updates have been committed since the last major release.

when there a no content files -> panic: runtime error: index out of range

i created all needed directories. when I run hugo, i get this error when the content folder is empty:

panic: runtime error: index out of range

goroutine 1 [running]:
github.com/spf13/hugo/hugolib.(_Site).BuildSiteMeta(0xc2000f3c00)
/Users/sebastian/go/src/github.com/spf13/hugo/hugolib/site.go:247 +0x67a
github.com/spf13/hugo/hugolib.(_Site).Process(0xc2000f3c00)
/Users/sebastian/go/src/github.com/spf13/hugo/hugolib/site.go:79 +0x9b
github.com/spf13/hugo/hugolib.(*Site).Build(0xc2000f3c00)
/Users/sebastian/go/src/github.com/spf13/hugo/hugolib/site.go:63 +0x25
main.buildSite(0x590100, 0x26)
/Users/sebastian/go/src/github.com/spf13/hugo/main.go:141 +0x63
main.main()
/Users/sebastian/go/src/github.com/spf13/hugo/main.go:119 +0x6d2

goroutine 2 [syscall]:

goroutine 4 [runnable]:
text/template/parse.lexText(0xc2000e7480, 0x3f4ef0)
/usr/local/go/src/pkg/text/template/parse/lex.go:228 +0x361
text/template/parse.(*lexer).run(0xc2000e7480)
/usr/local/go/src/pkg/text/template/parse/lex.go:198 +0x3e
created by text/template/parse.lex
/usr/local/go/src/pkg/text/template/parse/lex.go:191 +0x111

YAML front matter parsing errors kill hugo in server mode

I've mentioned this already in comments of #30, but it might make sense to make an issue out of it.

If I have poor YAML in my front matter, such as no quotes around a string that contains colons, e.g.

title: This thing: crashes

then servermode hugo will crash in this fashion:

Invalid YAML in /Users/arasinen/src/postposterous/content/bjing/2010-04-26-hei-maailma.md
Error parsing page meta data: YAML error: mapping values are not allowed in this context

My expected result is that the server would not actually crash, but rather print out an error message to stderr. A crashing server breaks the workflow in a non-intuitive way.

It would be nice to have if the error message were printed in red in supporting terminals, but that is not necessary.

Also, it would be nice to have something generated even when metadata parsing fails. Perhaps there should be a variable that says parsing fails. Then template builders can add desired warnings to output themselves.

Documentation for listing pages

I've been trying to create a list of links to recent posts on an index page, and have not been able to work out how to do this. I assume it has something to do with .Site.Recent, but can't get anything I've tried to not abort page generation.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.