Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cecilapp/url

URL manager and shortener, powered by Cecil.
https://github.com/cecilapp/url

cecil cecil-starter netlify shorten-urls shorturl static-site

Last synced: 10 days ago
JSON representation

URL manager and shortener, powered by Cecil.

Host: GitHub
URL: https://github.com/cecilapp/url
Owner: Cecilapp
License: mit
Created: 2020-01-14T16:41:52.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-01-04T22:21:53.000Z (12 months ago)
Last Synced: 2024-04-14T01:06:00.590Z (9 months ago)
Topics: cecil, cecil-starter, netlify, shorten-urls, shorturl, static-site
Language: Twig
Homepage: https://url.cecil.app
Size: 88.9 KB
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

**_URL_** is an URL manager (and shortener) powered by [Cecil](https://cecil.app) (a static site generator).

## How does it work?

_URL_ is files based, so it nead a file to handle the redirection from the `slug` to the target URL.
So you just have to create this file then _URL_ does the rest of the job.

_URL_ creates:

1. an HTML file for each URL including the [HTML redirect](https://developer.mozilla.org/docs/Web/HTTP/Redirections)
2. a [Netlify Redirects](https://docs.netlify.com/routing/redirects/) file
3. an Apache `.htaccess` file

## Usage

### Create an URL

To create a new URL just create a Markdown file in the `pages/` directory, with a `redirect` variable stored in the front matter.

#### Example

File name: `ggl.md`

File content:

```yaml
---
redirect: https://www.google.com/search?q=cecil+static
---
```

Demo:

### Build and deploy

1. Clone this repository and install components with `composer install`, or run `composer create-project cecil/url myproject`
2. Download [Cecil](https://cecil.app/download/)
3. Build the website: `php cecil.phar build`
4. Deploy the `_site` directory on your Web server

#### With Netlify

[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/Cecilapp/cecil.link&stack=cms)

## License

_URL_ is a free software distributed under the terms of the MIT license.