From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Thomas S. Dye" Subject: Re: Moving from Jekyll to Orgmode Date: Fri, 04 May 2018 05:07:02 -1000 Message-ID: <87y3gzbgtl.fsf@tsdye.com> References: <1524949519.21032.171.camel@gmail.com> <874ljump59.fsf@atmarama.com> <02CE4F97-08E0-4A50-9CE5-68D0D7712ACD@zzamboni.org> <87zi1fykxa.fsf@tsdye.com> Mime-Version: 1.0 Content-Type: text/plain; format=flowed Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:40320) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fEcIs-0007pC-Al for emacs-orgmode@gnu.org; Fri, 04 May 2018 11:07:23 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fEcIp-0005nQ-46 for emacs-orgmode@gnu.org; Fri, 04 May 2018 11:07:22 -0400 Received: from outbound-ss-1486.bluehost.com ([69.89.26.139]:55123) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fEcIo-0005mo-Qv for emacs-orgmode@gnu.org; Fri, 04 May 2018 11:07:19 -0400 Received: from cmgw11.unifiedlayer.com (unknown [10.9.0.11]) by gproxy1.mail.unifiedlayer.com (Postfix) with ESMTP id ABD61175A61 for ; Fri, 4 May 2018 09:07:10 -0600 (MDT) In-reply-to: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Kaushal Modi Cc: Luis Roca , Diego Zamboni , emacs-orgmode@gnu.org Aloha Kaushal, Kaushal Modi writes: > Hello Thomas, > > On Fri, May 4, 2018 at 2:50 AM Thomas S. Dye > wrote: > >> This looks like an interesting project. >> >> I've browsed the various Hugo themes and the example web sites. >> I >> think I've seen websites similar to and themes suitable for a >> variety of sites I'd like to consolidate: archaeology course >> syllabus and class calendar; documentation for a software >> project; >> a publication list with download links; and a book/article >> review >> blog. > > > That's correct, you can use Hugo to generate any of those kinds > of sites. I > use it for my blog, the ox-hugo doc site itself, the bare-bones > ox-hugo > test site, product doc site at work. I have also used it in the > past for a > "for-rent" site in the past (and it worked ;-)). > > >> I use org-mode for writing these kinds of thing now, and >> I'm hoping to work out a way to make my org mode source work >> with >> Hugo. >> > > At minimum you just need the #+hugo_base_dir keyword and > EXPORT_FILE_NAME > property (if using per-subtree flow). So it should not be too > difficult. To > get an idea, I made these[1] changes to make the pre-existing > use-package > Org manual ready for ox-hugo export. > > >> I'm especially keen on previewing the web pages as I work on >> them, >> which was super easy to set up (thanks!), > > > Great! So I gather that you were able to get a preliminary setup > of > ox-hugo + Hugo working? Yes, your ox-hugo test site was up and running in a few minutes. Every few seconds new blog entries would pop up on my browser as Hugo processed the test file. The hardest part for me was getting ox-hugo to work in spacemacs. This isn't an ox-hugo thing. I've had problems with other org mode components in spacemacs, mostly having to do with the order things are loaded. > > >> and generating "responsive" content to satisfy my smartphone >> connected >> students. >> > > That part is not too difficult if you want to get the basic > responsiveness.. just adding the viewport meta tag in HTML head > does most > of the job: > > > > You need to get into CSS hacking if you want to go further in > @media based > CSS formatting, or implementing CSS grids, etc. > Apparently, there is a 'responsive' module for Hugo that several themes use. I'm hoping to find responsiveness out of the box through careful choice of themes. >> I see that ox-hugo and many Hugo templates have a blog as their >> focus. Is it reasonable to go down the ox-hugo path for my >> planned sites? > > > I think so, as I mentioned earlier, I have used it for a variety > of sites. > The Hugo theme tagging system is not great as it relies > completely on what > the theme authors manually tag those as. But this[2] gives a > small > selection of themes for documentation sites. I might find more > sites that > fit your needs as you explore each of the themes on that site > (don't reply > 100% on tags). > > >> Or, is the blog focus likely to restrict what I'd like to do? >> > > Hugo Go templating is very powerful[3]. It inherently has no > restrictions. > The templating language does not have a "blog focus". > > If you decide to use a theme, just as is[*], then that's a > restriction. I > would suggest to pick a theme that best fits your need, and then > gradually > mold (mould?) it as you learn more of Go templating, to make it > perfect for > you. Perfect. Thanks. I'm looking forward to getting started with ox-hugo. Many thanks for the useful links. All the best, Tom > Thanks. > > Kaushal > > > [1]: > https://github.com/jwiegley/use-package/commit/dede56276ce157fb55f84562b10a70978c34230e#diff-980e09e4bfed99830873c784dfb12a7a > > [2]: https://themes.gohugo.io/tags/documentation/ > > [3]: Here are some of the professional non-blog sites created > using Hugo: > https://gohugo.io/showcase/. > > [*]: Being Emacs users, I doubt if the "use the theme as is" > would work for > any of us ;-) -- Thomas S. Dye http://www.tsdye.com