prose/starter

A starter site for Jekyll + Prose

Prose

Prose provides a beautifully simple content authoring environment for CMS-free websites. It's a web-based interface for managing content on GitHub. Use it to create, edit, and delete files, and save your changes directly to GitHub. Host your website on GitHub Pages for free, or set up your own GitHub webhook server.

Read more about Prose

Setting up Prose with your site

Prose supports configuration settings with a variety of options, which makes it easy to adjust the application to support your project needs. Read the Getting Started Guide to learn more.

Installation and developing

Help contribute

Prose project is currently looking for new maintainers.

Prose is hosted at Prose.io, or you can use on your own server. For installation instructions and contributing guidelines, please read contributing.md. For deploying to your own server, read deployment.md.

Getting help

Have questions? Jump into the #prose channel on irc.freenode.net.

New to Internet Relay Chat? Join quickly & easily using your Web browser or sign-up for a no-cost account on IRCcloud.

starter's Issues

"jekyll serve --watch" not working

Hi there,

After installing Jekyll as per instruction from the Jekyll website my first attempt at getting this repo to run via "jekyll serve --watch" failed. I was informed that Jekyll wasn't installed, it was installed via gem, i.e.

sudo gem install jekyll

So I installed it again, this time with

sudo atitude install jekyll

The next attempt to run via "jekyll serve --watch" also failed, informing me that --watch is an invalid option. So I tried without the --watch option and it says that it started successfully, unfortunately the suggested URL, http://localhost:4000/starter does not work.

Any idea what I'm doing wrong?

Cheers in advance.

Image upload in metadata config panel

Would it be possible to include an image upload button to the metadata panel? As I understand it, the only way to dedicate a specific image as a metadata item is to paste the url of the image to a text input. But non-developers will probably find this a bit confusing. I see in your example project that you have a text input for your splash image.

Flesh this out more and add all the configurable options available in prose.io

TODO - this should clearly represent configuration options documented here: https://github.com/prose/prose/wiki/Configuration

`/starter' not found.

I've cloned repo, started jekyll serve --watch, went to http://localhost:4000/starter and get 404 error page ``/starter' not found.`

Starter guide: CNAME needs adjusting or removing

Css doesn't connect up.

Hey there! I've forked the repository, and changed the _config, just as directed. But my css doesn't seem to connect up. This is wat I get:

http://murphyrandle.com/bootstrap/

Thanks!

---

http://bootstrap.prose.io/ 404s

:(

Metadata for static pages

I have all of my static pages like about.md and contact.md in the root directory of my project. I can't seem to get the custom metadata editing to work for these entries. For files in _posts it works great. What am I missing?

Here is my Prose section of my _config.yml:

prose:
  rooturl: ''
  siteurl: 'http://meetcircle.co/'
  relativeLinks: 'http://meetcircle.co/links.jsonp'
  media: 'media'
  ignore:
    - public/
    - /_includes
    - /_layouts
    - /_sass
    - /blog
    - 404.html
    - .gitignore
    - _config.yml
    - atom.xml
    - links.jsonp
    - sitemap.xml
    - styles.scss
  metadata:
    _posts:
      - name: "layout"
        field:
          element: "hidden"
          value: "post"
      - name: "title"
        field:
          element: "text"
          label: "Title"
          value: ""
      - name: "nav"
        field:
          element: "select"
          label: "Navigation"
          placeholder: "Choose Nav type"
          options:
            - name: "None"
              value: "none"
            - name: "Primary"
              value: "primary"
            - name: "Secondary"
              value: "secondary"
            - name: "Support"
              value: "support"
    _site:
      - name: "layout"
        field:
          element: "hidden"
          value: "page"
      - name: "title"
        field:
          element: "text"
          label: "Title"
          value: ""
      - name: "nav"
        field:
          element: "select"
          label: "Navigation"
          placeholder: "Choose Nav type"
          options:
            - name: "None"
              value: "none"
            - name: "Primary"
              value: "primary"
            - name: "Secondary"
              value: "secondary"
            - name: "Support"
              value: "support"

bundle exec jekyll serve

When using bundler, jekyll serve --watch results in an error:

WARN: Unresolved specs during Gem::Specification.reset:
redcarpet (~> 3.1)
WARN: Clearing out unresolved specs.
Please report a bug if this causes problems.
/usr/local/lib/ruby/gems/2.1.0/gems/jekyll-2.5.3/bin/jekyll:21:in block in <top (required)>': cannot load such file -- jekyll/version (LoadError) from /usr/local/lib/ruby/gems/2.1.0/gems/mercenary-0.3.5/lib/mercenary.rb:18:inprogram'
from /usr/local/lib/ruby/gems/2.1.0/gems/jekyll-2.5.3/bin/jekyll:20:in <top (required)>' from /usr/local/bin/jekyll:23:inload'
from /usr/local/bin/jekyll:23:in `

'

The correct command to run a local server is bundle exec jekyll serve. Just thought you might want to update the readme for people new to bundler.

Thanks for the great tool!

Question about metadata

I can't seem to get metadata to work. I configured the metadata to show a title field but nothing seems to make it show in a new post, when I click the metadata button. I've copied and pasted this from the starter repo but still no cigar.

I'd appreciate any help. Thanks!

My config.yml is this:

name: "title"
description: ""
url: "url"
paginate: 10
markdown: rdiscount
permalink: :title

prose:
media: 'images'
metadata:
_posts:
- name: "title"
field:
element: "text"
label: "Title"
value: ""

Could not find gem github-pages

Installing the starter project per the instructions in the README and trying to run it via
bundle exec Jekyll serve results in this failure:
Could not find gem 'github-pages' in any of the gem sources listed in your Gemfile.

This is of particular interest to me as I do not intend to use Prose for a GitHub-pages hosted site, at least not initially.
EDIT: env details
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-darwin17]

Title is still "Pool"

I see that "Poole" was renamed to "Prose" in the README, but there are still remnants, as seen in the title (of prose).

Adding TITLE attribute when inserting external link breaks the link

When inserting an external link, if the URL and link text fields are supplied, that is fine, but if the title field is also supplied, the output for the link is incorrect, resulting in double-quotes in the wrong place and resulting in no 'title' attribute as would be expected.