Pour tout problème contactez-nous par mail : support@froggit.fr | La FAQ :grey_question: | Rejoignez-nous sur le Chat :speech_balloon:

Skip to content
Snippets Groups Projects
Commit 4ff48a25 authored by Christophe Chaudier's avatar Christophe Chaudier :rocket:
Browse files

build: init project with staticast

parent 76489adf
No related branches found
No related tags found
1 merge request!1Resolve "init site with staticast"
Showing with 1784 additions and 46 deletions
# editorconfig.org
root = true
[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
[*.md]
trim_trailing_whitespace = false
[*.twig]
insert_final_newline = false
# Auto detect text files and perform LF normalization
* text=auto
.site/
.cecil/
.cache/
vendor/
_site/
themes/
node_modules/
LICENSE 0 → 100644
MIT License
Copyright (c) Arnaud Ligny
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
![Build Status](https://gitlab.com/pages/plain-html/badges/master/build.svg) # Staticast
--- _Staticast_ is a ready to use Progressive Web App to publish your podcast, with a RSS feed ready for syndication platforms, and a user friendly CMS.
Example plain HTML site using GitLab Pages. [![Staticast preview](https://user-images.githubusercontent.com/80580/150656228-4e7b08e2-b3f3-4c54-9bb1-818260e88e19.png)](https://staticast.cecil.app)
Learn more about GitLab Pages at https://pages.gitlab.io and the official ## Installation
documentation https://docs.gitlab.com/ce/user/project/pages/.
--- ### Manually
_Staticast_ is a website generated by [Cecil](https://cecil.app), so you need to download and run Cecil to build your website, then you can publish it where you want.
1. Be sure PHP (>=7.4) is available on your OS
2. [Download _Staticast_](https://github.com/Cecilapp/staticast/archive/master.zip) and install themes with `composer install`
3. [Download `cecil.phar`](https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar) and move it to the root of _Staticast_
### Automatically
<!-- START doctoc generated TOC please keep comment here to allow auto update --> Use the button to get your own copy of the repository on [Netlify](https://www.netlify.com).
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [GitLab CI](#gitlab-ci) [![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/Cecilapp/staticast&stack=cms)
- [GitLab User or Group Pages](#gitlab-user-or-group-pages)
- [Did you fork this project?](#did-you-fork-this-project)
- [Troubleshooting](#troubleshooting)
<!-- END doctoc generated TOC please keep comment here to allow auto update --> This will setup everything needed for running your website, with a CMS:
## GitLab CI - A new repository in your GitHub account
- Continuous Deployment to Netlify's CDN
- Control users and access with Netlify Identity
- Manage content with Netlify CMS
This project's static Pages are built by [GitLab CI][ci], following the steps ## Usage
defined in [`.gitlab-ci.yml`](.gitlab-ci.yml):
### Create a new episode
1. Add the MP3 file in `assets` directory
2. Create a new Markdown file in `pages/episodes`
Example (`1.md`):
```yaml
---
title: "Episode #1"
episode:
file: episode-1.mp3
---
Short description of the episode.
<!-- break -->
Notes of the episode.
``` ```
image: alpine:latest
Refer to _[Podcast component theme](https://github.com/Cecilapp/theme-podcast#usage)_ for advanced options.
pages:
stage: deploy ### Preview
script:
- echo 'Nothing to do...' Run the following command:
artifacts:
paths: ```bash
- public php cecil.phar serve --open
only:
- master
``` ```
The above example expects to put all your HTML files in the `public/` directory. ### Publish
## GitLab User or Group Pages 1. Run `php cecil.phar build`
2. Copy `_site` folder to your web server
To use this project as your user/group website, you will need one additional ### Configuration
step: just rename your project to `namespace.gitlab.io`, where `namespace` is
your `username` or `groupname`. This can be done by navigating to your
project's **Settings**.
Read more about [user/group Pages][userpages] and [project Pages][projpages]. Edit the [`config.yml`](https://github.com/Cecilapp/staticast/blob/master/config.yml) file, and more precisely the `podcast` section.
## Did you fork this project? > For details, please refer to the [Cecil documentation](https://cecil.app/documentation/configuration/).
If you forked this project for your own use, please go to your project's ## Development
**Settings** and remove the forking relationship, which won't be necessary
unless you want to contribute back to the upstream project. _Staticast_ use [Tailwind CSS](https://tailwindcss.com) so you can customize the stylesheet with the following files:
- Configuration: [`tailwind.config.js`](tailwind.config.js)
- CSS: [`assets/tailwind.css`](assets/tailwind.css)
```bash
# install
composer install
npm install
# build CSS
npx tailwindcss -i ./assets/tailwind.css -o ./assets/styles.css --watch
# serve
php cecil.phar serve -v --config=config/dev.yml
```
## Troubleshooting ## License
1. CSS is missing! That means that you have wrongly set up the CSS URL in your _Staticast_ is a free software distributed under the terms of the MIT license.
HTML files. Have a look at the [index.html] for an example.
[ci]: https://about.gitlab.com/gitlab-ci/ © [Arnaud Ligny](https://arnaudligny.fr)
[index.html]: https://gitlab.com/pages/plain-html/blob/master/public/index.html
[userpages]: https://docs.gitlab.com/ce/user/project/pages/introduction.html#user-or-group-pages
[projpages]: https://docs.gitlab.com/ce/user/project/pages/introduction.html#project-pages
assets/cover.png

39.1 KiB

assets/episode-1-share.png

37.6 KiB

File added
assets/episode-1.png

41.1 KiB

File added
File added
File added
assets/favicon.png

3.61 KiB

assets/icons/apple.png

14.6 KiB

assets/icons/google.png

5.99 KiB

assets/icons/rss.png

6.64 KiB

assets/icons/spotify.png

8.73 KiB

assets/manifest/icon-192x192.png

2.93 KiB

assets/manifest/icon-512x512.png

9.32 KiB

This diff is collapsed.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment