still - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #react #go #golang #deep-learning #linux #docker #macos #java #cli #vue #ios #open-source

still

(★ 257)

A composable Elixir static site generator

파일 탐색기

최종 버전 다운로드 (.zip)

- - build.yml
  - site.yml
- functions
- lint
- server
- setup
- config.exs
- dev.exs
- prod.exs
- site.exs
- test.exs
- - hooks.md
  - preprocessors.md
- - configuration.md
  - data.md
  - getting_started.md
  - pagination.md
  - template_languages.md
  - templates.md
- .formatter.exs
- .gitignore
- mix.exs
- README.md
- - application.ex
  - data.ex
  - preprocessor.ex
  - process_watcher.ex
  - profiler.ex
  - source_file.ex
  - utils.ex
  - watcher.ex
- still.ex
- - _layout.slime
  - CNAME
  - console.js
  - index.slime
- - dev.slime
  - profiler.slime
- - dev.exs
- - data_test.exs
  - preprocessor_test.exs
  - profiler_test.exs
- test_helper.exs
.credo.exs
.formatter.exs
.gitignore
.tool-versions
LICENSE
mix.exs
mix.lock
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Still: a composable Elixir static site generator

![Still logo](https://raw.githubusercontent.com/still-ex/still/master/priv/site/images/banner.png)

[![][build-badge]][build]
[![][hex-badge]][hex]
[![][docs-badge]][docs]

🚧 **This package is still in progress - _badumm tss_**

Still is a different take on building static sites.

Still takes a step back from the status quo, to a simpler time, without
compromising on the great developer experience some of us have grown used to.

Still is the web, still how you used to. Still weird. Still simple.

Still focuses on your happiness and speed of development. It automates the
boring parts and leaves the good ones to you.

Still shines the spotlight on your abilities to write the best code you can. It
is customisable, composable and as extensible as you want to. It is as powerful
as you are.

Still is our gift to the community. Stay simple. Stay weird.

For more information please read the [documentation][docs].

## Installation

To install Still you add it to your dependency list. You should be able to
add it to any mix project.

### For new projects

Run `mix archive.install hex still_new` to install the archive on your system.

Afterwards, create a static site by running `mix still.new my_site`.
That's it!

### Adding to an existing project

Add `still` as a dependency in `mix.exs`:

```elixir
def deps do
  [
    {:still, "~> 0.8.0"}
  ]
end
```

Open up `config.exs` and set the input and output folders:

```elixir
config :still,
  input: Path.join(Path.dirname(__DIR__), "priv/site"),
  output: Path.join(Path.dirname(__DIR__), "_site")
```

Create a file `index.slime` in the input folder.

For more information please visit the [website][website].

## Contributing

If you're considering contributing to Still, thank you. We keep an updated list
of bugs and features on the [issue tracker][issue-tracker]. If you can't find
the bug or feature you have in mind, please open an issue first, before creating
a pull request.

### Requirements & Setup

1. Download the repo
```sh
$ git clone https://github.com/still-ex/still.git
```
2. Move to project directory & Install dependencies
```sh
$ cd still && ./bin/setup
```
3. Optionally, install an image processor

Some of the tests related to images require an image processor to be installed.
By default, Still relies on [ImageMagick][imageMagick], but if you install [still-imageflow][still-imageflow] as a 
dependency it will use [imageflow][imageflow] instead.

From this point onwards, you should be ready to go.
### Expected Pull Request contents

Please make sure the PR title and description clearly explain the proposed
changes. Linking to a relevant issue by adding `Closes *ISSUE_NUMBER*` on the PR
description is very welcomed.

All proposed changes should be accompanied by unit tests that provide coverage
for those changes.

### Running tests

To run tests, simply run the following  on the project directory.
```sh
$ mix test
```

## About

Still was created and is maintained with :heart: by [Subvisual][subvisual].

![Subvisual][sub-logo]

## License

Still is released under the [ISC License](./LICENSE).

[website]: https://stillstatic.io
[subvisual]: https://subvisual.com
[docs]: https://hexdocs.pm/still/getting_started.html
[hex]: https://hex.pm/packages/still
[build]: https://github.com/still-ex/still/actions
[sub-logo]: https://raw.githubusercontent.com/subvisual/guides/master/github/templates/logos/blue.png
[hex-badge]: https://img.shields.io/hexpm/v/still?style=flat-square
[build-badge]: https://img.shields.io/github/workflow/status/still-ex/still/Elixir%20CI?style=flat-square
[docs-badge]: https://img.shields.io/badge/-docs-informational?style=flat-square
[issue-tracker]: https://github.com/still-ex/still/issues
[imageMagick]: https://imagemagick.org/index.php
[still-imageflow]: https://github.com/still-ex/still_imageflow
[imageflow]: https://github.com/imazen/imageflow