punch

punch copied to clipboard

Hi, but what if I want to just use the static HTML without a server, do I have to find and replace all urls from /about to /about/index.html? Because at the moment it links to /about but there is a folder /about created with and index.html within.

You can use punch generate (punch g) command to generate the static HTML. More details here - https://github.com/laktek/punch/wiki/Generating-a-Site

That's not what joranovski is asking laktek. Currently Punch generates internal URLs as 'clean' URLs e.g. /about rather than /about/index.html – what that means is you need a web server capable of dealing with clean URLs in order for the output to be useful. For Apache 2 it's the option MultiViews that's required, without it internal links in Punch sites will fail (including menus).

So for truly static HTML that isn't served up with a server – an HTML based manual supplied with software, for instance (don't know what joranovski's use case is) – you need the link to be explicit "/about/index.html" or it just wont work (unless you manually fix all internal links, as suggested).

As far as I know Punch can't do this at the moment. Perhaps a flag to punch g is needed to output the full path, not a clean URL.

@joranovski @adrinux There isn't a built-in link helper in Punch, so you might either write a custom helper for that or just manually specify the URL.

@laktek generating the static HTML was indeed not the problem with punch g @adrinux your right, generating the static HTML wasn't the problem, the routing without a server is. My usecase is that I made a UI styleguide and I want it to work without using a server. So only the static HTML for people to deal with. I'm not a programmer so I guess I have to roll up my sleeves and get my hands dirty ;)

I think this needs to be a feature, it's a fairly obvious use case for a 'static' site generator =D

That said, if you've only a handful of links that need changed @joranovski you could just do them manually.

@adrinux Yep I second that! :) Unfortunately there are more then a handful though :(