guillep / ecstatic

ecstatic site generator

Disclaimer

This repository is not maintained anymore. It is only kept here for historical and documentative purposes.

A modern way to generate documents with Pharo can be found in pillar and microdown. See

• https://github.com/pillar-markup/pillar
• https://github.com/pillar-markup/Microdown/

Ecstatic

Ecstatic is the ecstatic site generator for Pharo. Ecstatic uses pillar as its markup language to describe pages, mustache templates to accommodate your content and plugins completely written in Pharo.

Installation & Usage

For installation and usage, check ecstatic's website:

http://guillep.github.io/ecstatic/

For installation on Windows, download this file :

https://mega.nz/#!RAcGHQ6Q!ab9Z05KjXDvUQtJW3Er5416SlR28l6UV_H3lIKZ8hfs

About Pillar

Pillar is a document model for Pharo that can be exported to different formats such as HTML or LaTex. Pillar defines also a syntax to describe documents and provides a parser for it. To know a bit more about how to write pillar documents you may find useful the two following links.

• Pillar Cheat Sheet
• Pillar docs

TODOs

• Plugins should be parameterized with the site and use always files relative to the origin
• last changes to citezen should be commited
• extend pillar annotations to declare plugins

ecstatic's Issues

Ecstatic script doesn't support ubuntu.

Following the tutorial describe in first side

The script on ecstatic has the option --headless aparently this is not compatible with my Ubuntu 15.04

Add shebang to scripts

I do not use bash as default shell and since the scripts do not contain shebang I cannot run them easily.

They should include a shebang such as: #!/usr/bin/env bash

align inbuilt web server port with Jekyll ? i.e. 4000

Jekyll's association with github seems to make it very popular. It uses port 4000 for its inbuilt web server. It might be useful to align with this. 8080 seems like convention used for proxies. 4000 is intuitive as "half-of" a web server.

Document "How to create a new Theme?"

Hi @LingMA2017,

Could you write a little tutorial on what to do to create a new theme?

Documentation needed for the use of ecstatic-win file

As guillep suggested, there should be a few indications on how to use the file.

Rename /siteDirectory/ ivar & accessors to /rootDirectory/

This seems a little confusing that _site is being appended to "site" directory. A site within a site?

ETSite>>outputDirectory
^ (self siteDirectory / '_site') ensureCreateDirectory

Can we rename /siteDirectory/ instance variable & accessors to /rootDirectory/ ?

Update highlight js in the templates to use the latest version

In order to get some bugfixes and new features of highlight js

web service showing dynamic generation should serve files out of root URL

Running...
$ ecstatic serve -w
reports... "Serving website at: http://localhost:8080//ecstatic"

This should just be http://localhost:8080/
just like it would appear when downloaded to real web host.

generate does not take all pillar files

We have
fast_feedback.pillar getting_started.pillar install.pillar _site
first_site.pillar index.pillar pillar.conf theme
files in our directory.
When we generate ('ecstatic generate' or 'ecstatic serve -w') 'getting_started.html' doesn't appear in '_site'.

Use Pharo 64bits by default

I tried to use ecstatic on Linux subsystem of windows but the installation failed because Linux subsystem only supports Pharo 64bits.

What do you think about using Pharo 64bits by default in the installation script? Is there objections?

Need for an easy way to install Ecstatic on Windows

The script given for installation is made for Linux ; a way to install Ecstatic on Windows might be helpful

DNU because CZPillarDocBuilder is Undeclared in ETPublicationsPlugin>>exportInto:

Hi. Just did setup ecstatic from scratch after a while (maybe since December) and I found this issue when running ecstatic generate on my personal website. May be some change in Pillar and/or Citezen is the cause.

Still didn't investigate... any clue? Can you reproduce with your site @guillep ?

Cheers

Document in ecstatic website " how to get syntax highlighting "

To know that each theme implements its own highlighting, mostly using highlight js

Windows installation link is broken

The link in the README to install ecstatic on Windows is dead.

https://mega.nz/#!RAcGHQ6Q!ab9Z05KjXDvUQtJW3Er5416SlR28l6UV_H3lIKZ8hfs