mirror of
https://github.com/srid/ema.git
synced 2024-11-29 09:25:14 +03:00
e6df45a7ac
* Rewrote tailwind css as inline vanilla css * Explicitly set font-size, tab-size, line-height * Add box-sizing + adjust width/height This will subtract border and padding from the element width/height making it consistent across different resolutions. * Link to original version * Add to changelog Co-authored-by: Sridhar Ratnakumar <srid@srid.ca>
99 lines
5.5 KiB
Markdown
99 lines
5.5 KiB
Markdown
# Revision history for ema
|
|
|
|
## 0.8.0.0 (Unreleased)
|
|
|
|
This releases brings a significant rewrite of Ema. If you choose to upgrade your apps from 0.6, see https://ema.srid.ca/howto/upgrade for guidance.
|
|
|
|
- GHC 9.0 support
|
|
- Better handling of URL anchors (#83; #87)
|
|
- `routeUrl` uses `UrlDirect` by default. Use `routeUrlWith` if you want to change that.
|
|
- Ema status indicator now works independently (requires no Tailwind)
|
|
- Multisite rewrite (Ema is mostly rewritten)
|
|
- Add the notion of route `Prism_` (first-class values), along with a `IsRoute` class to define them.
|
|
- Optional generic deriving of route prisms, so you do not have to hand-write them.
|
|
- Automatic isomorphism checks ensures that encoding and decoding are isomorphic.
|
|
- Composable Ema apps
|
|
- There are two ways of composing Ema apps. Using heterogenous lists (see `Ema.Route.Lib.Multi`), or by defining a top-level route type (see `Ex04_Multi.hs`).
|
|
- Replace `LVar` with `Dynamic`.
|
|
- Ema still uses `LVar` internally (for live server updates), but on the user-side one only needs to provide a `Dynamic` which is a tuple of initial value and an updating function. The [unionmount](https://github.com/srid/unionmount/pull/1) library was changed to provide this tuple.
|
|
- Add `EmaSite` typeclass to "connect them all"
|
|
- `SiteArg`: Type of value to pass from the environment.
|
|
- `siteInput`: Define the `Dynamic` model for the site.
|
|
- `siteOutput`: Asset (eg: HTML) to produce for each route.
|
|
|
|
## 0.6.0.0 -- 2022-02-05
|
|
|
|
- Websocket API: Add `ema.switchRoute` to switch to other routes in live server.
|
|
- Smaller core: remove helpers and examples (examples can be enabled by a flag)
|
|
- Helpers
|
|
- `Ema.Helpers.PathTree` moved to separate package *pathtree*.
|
|
- `Ema.Helpers.FileSystem` moved to separate package *unionmount*.
|
|
- `Ema.Helpers.Markdown` moved to separate package *commonmark-simple*.
|
|
- `Ema.Helpers.Blaze` is no more. See `ema-template` if you need a ready made template using blaze HTML and TailwindCSS.
|
|
- Examples `with-examples` cabal flag is made False by default. Examples are not exposed modules.
|
|
- `Ema.Route.Slug` moved to separate package *url-slug*
|
|
|
|
## 0.4.0.0 -- 2022-01-19
|
|
|
|
- Pin TailwindCSS to 2.x, because the 3.x broke our CDN url
|
|
- Remove unused Cabal deps (#61)
|
|
- `Tailwind.layoutWith`: don't hardcode `<body>` attrs
|
|
- Tailwind: module revamped and renamed to `Tailwind.Helper.Blaze`
|
|
- `runEma` and friends:
|
|
- return the monadic's action's return value or generated files (dependent type)
|
|
- CLI: add `run` subcommand that takes `--host` and `--port` (and remove environment hacks of $HOST and $PORT)
|
|
|
|
## 0.2.0.0 -- 2021-11-21
|
|
|
|
- TODO(doc) runEma's action gets the `CLI.Action` as argument, to prevent the `gen` command from needing to monitoring files.
|
|
- Live Server
|
|
- Avoid unncessary DOM patch on page load
|
|
- Handle invalid routes gracefully without breaking websocket
|
|
- Re-add `<script>` tags on hot reload
|
|
- Scroll to top on route switches
|
|
- Use secure websockets when on HTTPS
|
|
- Bind to loopback (127.0.0.1) for security reasons
|
|
- Do not handle target=_blank links in websocket route switch
|
|
- `Asset` type
|
|
- Introduce the `Asset` type to distinguishing between static files and generated files. The later can be one of `Html` or `Other`, allowing the live server to handle them sensibly.
|
|
- `Ema` typeclass:
|
|
- Drop `staticAssets` in favour of `allRoutes` (renamed from `staticRoutes`) returning all routes including both generated and static routes.
|
|
- Drop `Slug` and use plain `FilePath`. Route encoder and decoder deal directly with the on-disk path of the generated (or static) files.
|
|
- Make the render function (which `runEma` takes) return a `Asset LByteString` instead of `LByteString` such that it can handle all routes, and handle static files as well as generation of non-HTML content (eg: RSS)
|
|
- Allow copying static files anywhere on the filesystem
|
|
- `routeUrl`:
|
|
- Unicode normalize as well URI encode route URLs
|
|
- now returns relative URLs (ie. without the leading `/`)
|
|
- Use the `<base>` tag to specify an explicit prefix for relative URLs in generated HTML. This way hosting on GitHub Pages without CNAME will continue to have functional links.
|
|
- Fix: prevent encoding of non-HTML paths
|
|
- Now takes the `model` type as argument, inasmuch as `encodeRoute` takes it as as well (to accomodate scenarios where route path can only be computed depending on model state; storing slug aliases for instance)
|
|
- Add `routeUrlWith` for non-pretty URLs
|
|
- `Ema.Slug`
|
|
- Add `Ord`, `Generic`, `Data` and Aeson instances to `Slug`
|
|
- Unicode normalize slugs using NFC
|
|
- Add `decodeSlug` and `encodeSlug`
|
|
- Add default implementation based on Enum for `allRoutes`
|
|
- Warn, without failing, on missing static assets during static generation
|
|
- Static generation
|
|
- Use block buffering to prevent logging from slowing down site generation
|
|
- Write .nojekyll
|
|
- CLI
|
|
- Removed `-C` argument (orthogonal to Ema)
|
|
- Helpers
|
|
- Helpers.FileSystem
|
|
- Add Union mount support; re-exported from `unionmount` library
|
|
- enrich FileAction type to distinguish between existance and new and update states
|
|
- Helpers.Tailwind
|
|
- add overflow-y-scroll to body
|
|
- Add twind shim *before* application's head
|
|
- CDN: Use latest version always.
|
|
- Helpers.Markdown
|
|
- add helpers to parse markdown; `parseMarkdownWithFrontMatter` and `parseMarkdown`
|
|
- Examples
|
|
- ~~Remove Ex03_Documentation.hs (moved to separate repo, `ema-docs`)~~ Back to ./docs, but using Emanote.
|
|
- Add Ex03_Basic.hs example
|
|
|
|
## 0.1.0.0 -- 2021-04-26
|
|
|
|
* First version. Released on an unsuspecting world.
|