Relative image path to content / github preview support

banyanvines · August 9, 2016, 7:31pm

How do I have images in same directory or sub directory of a article? For example if my content is in content/dir1/page1.md, images can be in content/dir1 or a sub directory. That way github can view the content properly. It’s also much easier for users to update the content. Finding and storing images in static forder may be best technical solution, but it’s inconvenient for non technical users, which limits it’s usage. Ditto for github preview support, which works if images are in same or sub directory of content.

There seems to be some discussion I found on the forum, but it wasn’t clear to me if it’s supported and how. I tried putting images in same folder and didn’t work for me by default.

Paul_Reed · August 9, 2016, 10:42pm

Agree.
It would be brilliant if the paths in Hugo & Github could be aligned, it would make laying out pages so much easier.

For example; if the page displays OK in Github, it will display OK in Hugo.

Paul

bep · August 9, 2016, 11:10pm

The Docker kids added that feature (Docker uses Hugo for their docs), but they were not “great” in documenting that feature …

github.com

gohugoio/hugo/blob/91b61b976d8d32ef041506bcbc5f3ed3bf888986/helpers/content.go

// Copyright 2015 The Hugo Authors. All rights reserved.
//
// 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 helpers implements general utility functions that work with
// and on content.  The helper functions defined here lay down the
// foundation of how Hugo works with files and filepaths, and perform
// string operations on content.
package helpers

import (

This file has been truncated. show original

Do not ask me how it works or how you set it up. I might know. But don’t ask

banyanvines · August 10, 2016, 10:11pm

Thanks, setting it to “true” and putting images in same folder as .md file works for github, but does not work for hugo. Hugo converts filename.md to ‘filename/index.html’. So the image still stays one level up from index.html for hugo.

Any help how to configure it so it works for both hugo and github preview will be appreciated.

Topic		Replies	Views
Image path support	14	59174	November 26, 2019
Documents posted on GitHub looks different from rendered by Hugo support	2	624	January 13, 2024
Serve Image from within 'content' subdirectory support	3	1942	January 13, 2020
Article compatibility with Github	11	611	May 16, 2018
Images alongside content support	2	945	November 27, 2019

Relative image path to content / github preview support

Related Topics