locomotivecms / documentation Goto Github PK

The website sources about the new LocomotiveCMS documentation "center"

Ruby 1.20% JavaScript 3.78% CSS 95.03%

documentation's Introduction

LocomotiveCMS Documentation

Welcome to the documentation for LocomotiveCMS, an open source content management system. You can find this documentation online at http://doc.locomotivecms.com.

If you find errors, would like to add content, or have other contributions, please open a GitHub issue or submit a pull request. All contributions are greatly appreciated.

If you need help using LocomotiveCMS, please don't open an issue here. Instead post in our Google Group. Thanks!

Contributing

This repository is itself a LocomotiveCMS Wagon project. To contribute, first fork the repository. You can then clone it to your machine and make changes as you would to any LocomotiveCMS project and preview your changes with bundle exec wagon serve.

Once you've committed your changes, push them to your fork and send us a pull request.

All contributions are greatly appreciated. Further, we expect that pull requests addressing open issues will be greatly rewarded in the after life. 🙇

documentation's People

Contributors

Stargazers

Watchers

Forkers

gregory geraldoandradee geraudmathe jess ncloward qiaopeng55 gabriel-wilkes bmaland rjfranco gabrielnau pimpin agilee rlbrackett3 aaronrenner estellelocomotivecms maxim-filimonov glebe jasongonzales23 danieltran l0ck3 lengarvey artking skopp swolie jdlich hashnotadam woodnathan clekstro audionerd bijendra brandonmikeska papipo colibri-software warp ready4god2513 jadaw1n yrb rvalyi mpwh-zz interhive onnimonni joe8bit wichtig cdownard joshrieken roadt engelfrost marcelfahle manuchap srg-rmnv chancedowns dirklectisch qpowell johnsmall tasyjean atsign anny-goerl gravypower jimfisher meikoudras halsk joel hrsalazar boie0025 alexagui stabenfeldt jmcvetta tomz anja98 amejiarosario dinglixiang mrgcohen jbaldo conroywhitney yoshprogrammer trembolon58 tomtrentham rossbarnie adomas-s sophiedeziel fgo owenscott brandondrew burabure mjmirzazadeh jamesakers alexandrebroudin snuorch phuong3030 genius69 nitinsareen31 dustb0wl lcx dlsutariya danielvlopes dcmspe cllns aizad02 designingsean fro0z1k

documentation's Issues

'bundle exec unicorn_rails' stuck in some kind of loop on OS X 10.11

After following the OS X install guide for wagon and engine, I got all the way up to the bundle exec unicorn_rails command, but end up in some kind of error loop. This sort of thing goes on forever til I kill the process.

Obelus:test_cms josh$ bundle exec unicorn_rails
I, [2015-12-27T15:56:46.186405 #57860]  INFO -- : listening on addr=0.0.0.0:8080 fd=9
I, [2015-12-27T15:56:46.186526 #57860]  INFO -- : worker=0 spawning...
I, [2015-12-27T15:56:46.187314 #57860]  INFO -- : master process ready
I, [2015-12-27T15:56:46.188285 #57861]  INFO -- : worker=0 spawned pid=57861
I, [2015-12-27T15:56:46.188660 #57861]  INFO -- : Refreshing Gem list
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/values/time_zone.rb:270: warning: circular argument reference - now
/Users/josh/.rvm/gems/ruby-2.2.1/gems/locomotive_liquid-2.4.2/lib/liquid/htmltags.rb:43: warning: duplicated key at line 46 ignored: "index0"
/Users/josh/.rvm/gems/ruby-2.2.1/gems/fog-1.12.1/lib/fog/aws/compute.rb:200: warning: duplicated key at line 208 ignored: :internet_gateways
Digest::Digest is deprecated; use Digest
/Users/josh/.rvm/gems/ruby-2.2.1/gems/fog-1.12.1/lib/fog/rackspace/mock_data.rb:41: warning: duplicated key at line 79 ignored: "name"
E, [2015-12-27T15:56:48.080369 #57861] ERROR -- : undefined method `secret_key=' for Devise:Module (NoMethodError)
/Users/josh/Downloads/locomotive/test_cms/config/initializers/devise.rb:4:in `block in <top (required)>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/devise-2.2.7/lib/devise.rb:267:in `setup'
/Users/josh/Downloads/locomotive/test_cms/config/initializers/devise.rb:3:in `<top (required)>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/dependencies.rb:245:in `load'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/dependencies.rb:245:in `block in load'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/dependencies.rb:236:in `load_dependency'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/dependencies.rb:245:in `load'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/engine.rb:593:in `block (2 levels) in <class:Engine>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/engine.rb:592:in `each'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/engine.rb:592:in `block in <class:Engine>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:30:in `instance_exec'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:30:in `run'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:55:in `block in run_initializers'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:54:in `each'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:54:in `run_initializers'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/application.rb:136:in `initialize!'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/railtie/configurable.rb:30:in `method_missing'
/Users/josh/Downloads/locomotive/test_cms/config/environment.rb:5:in `<top (required)>'
config.ru:4:in `require'
config.ru:4:in `block in <main>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/rack-1.4.7/lib/rack/builder.rb:51:in `instance_eval'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/rack-1.4.7/lib/rack/builder.rb:51:in `initialize'
config.ru:1:in `new'
config.ru:1:in `<main>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn.rb:46:in `eval'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn.rb:46:in `block in builder'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/bin/unicorn_rails:139:in `call'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/bin/unicorn_rails:139:in `block in rails_builder'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:752:in `call'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:752:in `build_app!'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:617:in `init_worker_process'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:639:in `worker_loop'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:508:in `spawn_missing_workers'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:132:in `start'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/bin/unicorn_rails:209:in `<top (required)>'
/Users/josh/.rvm/gems/ruby-2.2.1/bin/unicorn_rails:23:in `load'
/Users/josh/.rvm/gems/ruby-2.2.1/bin/unicorn_rails:23:in `<main>'
/Users/josh/.rvm/gems/ruby-2.2.1/bin/ruby_executable_hooks:15:in `eval'
/Users/josh/.rvm/gems/ruby-2.2.1/bin/ruby_executable_hooks:15:in `<main>'
E, [2015-12-27T15:56:48.088377 #57860] ERROR -- : reaped #<Process::Status: pid 57861 exit 1> worker=0
I, [2015-12-27T15:56:48.088665 #57860]  INFO -- : worker=0 spawning...
I, [2015-12-27T15:56:48.090643 #57862]  INFO -- : worker=0 spawned pid=57862
I, [2015-12-27T15:56:48.091174 #57862]  INFO -- : Refreshing Gem list
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/values/time_zone.rb:270: warning: circular argument reference - now
/Users/josh/.rvm/gems/ruby-2.2.1/gems/locomotive_liquid-2.4.2/lib/liquid/htmltags.rb:43: warning: duplicated key at line 46 ignored: "index0"
/Users/josh/.rvm/gems/ruby-2.2.1/gems/fog-1.12.1/lib/fog/aws/compute.rb:200: warning: duplicated key at line 208 ignored: :internet_gateways
Digest::Digest is deprecated; use Digest
/Users/josh/.rvm/gems/ruby-2.2.1/gems/fog-1.12.1/lib/fog/rackspace/mock_data.rb:41: warning: duplicated key at line 79 ignored: "name"
E, [2015-12-27T15:56:50.011134 #57862] ERROR -- : undefined method `secret_key=' for Devise:Module (NoMethodError)
/Users/josh/Downloads/locomotive/test_cms/config/initializers/devise.rb:4:in `block in <top (required)>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/devise-2.2.7/lib/devise.rb:267:in `setup'
/Users/josh/Downloads/locomotive/test_cms/config/initializers/devise.rb:3:in `<top (required)>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/dependencies.rb:245:in `load'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/dependencies.rb:245:in `block in load'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/dependencies.rb:236:in `load_dependency'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/dependencies.rb:245:in `load'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/engine.rb:593:in `block (2 levels) in <class:Engine>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/engine.rb:592:in `each'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/engine.rb:592:in `block in <class:Engine>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:30:in `instance_exec'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:30:in `run'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:55:in `block in run_initializers'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:54:in `each'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/initializable.rb:54:in `run_initializers'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/application.rb:136:in `initialize!'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/railties-3.2.19/lib/rails/railtie/configurable.rb:30:in `method_missing'
/Users/josh/Downloads/locomotive/test_cms/config/environment.rb:5:in `<top (required)>'
config.ru:4:in `require'
config.ru:4:in `block in <main>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/rack-1.4.7/lib/rack/builder.rb:51:in `instance_eval'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/rack-1.4.7/lib/rack/builder.rb:51:in `initialize'
config.ru:1:in `new'
config.ru:1:in `<main>'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn.rb:46:in `eval'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn.rb:46:in `block in builder'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/bin/unicorn_rails:139:in `call'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/bin/unicorn_rails:139:in `block in rails_builder'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:752:in `call'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:752:in `build_app!'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:617:in `init_worker_process'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:639:in `worker_loop'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:508:in `spawn_missing_workers'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:519:in `maintain_worker_count'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/lib/unicorn/http_server.rb:283:in `join'
/Users/josh/.rvm/gems/ruby-2.2.1/gems/unicorn-5.0.1/bin/unicorn_rails:209:in `<top (required)>'
/Users/josh/.rvm/gems/ruby-2.2.1/bin/unicorn_rails:23:in `load'
/Users/josh/.rvm/gems/ruby-2.2.1/bin/unicorn_rails:23:in `<main>'
/Users/josh/.rvm/gems/ruby-2.2.1/bin/ruby_executable_hooks:15:in `eval'
/Users/josh/.rvm/gems/ruby-2.2.1/bin/ruby_executable_hooks:15:in `<main>'
E, [2015-12-27T15:56:50.017956 #57860] ERROR -- : reaped #<Process::Status: pid 57862 exit 1> worker=0
I, [2015-12-27T15:56:50.018098 #57860]  INFO -- : worker=0 spawning...
I, [2015-12-27T15:56:50.019711 #57863]  INFO -- : worker=0 spawned pid=57863
I, [2015-12-27T15:56:50.020107 #57863]  INFO -- : Refreshing Gem list
/Users/josh/.rvm/gems/ruby-2.2.1/gems/activesupport-3.2.19/lib/active_support/values/time_zone.rb:270: warning: circular argument reference - now
^CI, [2015-12-27T15:56:50.588528 #57860]  INFO -- : reaped #<Process::Status: pid 57863 exit 0> worker=0
I, [2015-12-27T15:56:50.588662 #57860]  INFO -- : master complete
Obelus:test_cms josh$

[Missing] Setup multi-sites

this page is missing: http://doc.locomotivecms.com/guides/multisites/setup

customer_message.errors is always true on commit

http://doc.locomotivecms.com/guides/create-a-contact-form

{% if customer_message.errors %} will always be true, so that example is incorrect. It works only because of different success/error callbacks.

No information about unique fields

No description of the unique property

Installing the Engine

I'm a Ruby newbie and just spent about an hour trying to get the engine installed and running. Everything worked great, but I ran into 2 issues that might be worth updating on your documentation site

On Step 4. Instead of using this command: "bundle exec rails g locomotive:install" I had to use this command: "rails g locomotive:install"
Once I got the engine running, the css/js files weren't being generated. I finally figured out that I had to add "config.assets.enabled = true" to my development.rb file. One I did that, the css and js files were generated properly.

Inline editing example in the "Get Started" page

No documentation on how to pull content entries through the api, or in general how to use locomotive as a service

Often a code base can become a mess when you have a cms, e-commerce platform, and other components jumbled into one app. It's more desirable in this case to keep those platforms separate, and consume then as needed through an API in the public facing application. This keeps the main app thin and flexible.

For those of us who want to use locomotive purely for its content editing, organization, and admin capabilities, and keep it separate from our consuming application, there is no documentation on how to pull content entries through a rest API.

I.E., let's say I want to create a list of classes available at a school in Locomotive. What would be the api call to A) get those list of classes and B) get the content for each class?

There should be some better documentation with examples of consuming Locomotive content from the outside.

An easier solution would be, when creating a content entry in the admin, to display it's publicly accessible url. Same could go for for folders of content entries.

Nesting blocks syntax change should be included in documentation

I've lost a number of hours trying to figure out why nesting blocks didn't work. I've read http://doc.locomotivecms.com/references/api/tags/block over and over again, but it seems to miss something.

After lot of googling I found out about the nested block syntax.

{% block 'content/nested-content' %} {% endblock %}

This is not included in documentation. It should be included and boldly highlighted.

Problem with auto generated content

Following the 'making blog' tutorial at http://doc.locomotivecms.com/making-blog I encountered problem which I can't overcome. After placing http://doc.locomotivecms.com/making-blog/posts.yml inside data/posts.yml and executing bundle exec wagon push development --data I get an error featured_image => can't be blank. This error is caused by the url in the file field. When I put there valid file url (like images/1024x768.png) everything works fine. How to force locomotivecms to accept urls like it is shown in the tutorial?
I get similar error in data/photos.yml for the post: field (same message). In my file there is only one photo entry with post: afternoon-delight (I checked that localhost:8080/posts/afternoon-delight exists). If anyone could help me with this I would be very thankful.
Locomotivecms looks great. For now it looks like the CMS I was looking for.

New attributes for the Page model in the 2.1 version of the engine

From this commit: locomotivecms/engine#681

templatized?
content_type

[Filter][Date] distance_of_time_in_words

Missing example files in making a blog tutorial

I noticed two files are missing that are referenced in the tutorial:

The example photos.yml in chapter 3-5
The 'gyeongbokgung-full.jpg' image from chapter 2-3

The second file is in the repo but doesn't seem to link correctly. The missing files didn't stop me from finishing the tutorial but still worth fixing.

Liquid Standard filters

List all of them (even without examples), the syntax is fine.

Documentation for developing "widgets"

Hi, we're evaluating Locomotive CMS to give our customers the ability to build template-driven websites on our SaaS platform. Our SaaS platform is managing some data for our customers and can probably push the data to Mongo so that it's available to Locomotive CMS as custom-objects.

Now, my question is that we need to show a lot of "widgets" on the template-driven websites. A customer should have the ability to drag/drop widgets into designated areas (pretty much like how it's done in Wordpress). A customer should have the ability to tweak/customize some widget-specific settings.A few examples of widgets:

Image slider on home page
Twitter feed widget
Weather widget
Upcoming events (our SaaS platform is for event ticketing)
Recently booked events

What's the recommended way to build this out on top of Locomotive CMS? Is there any doc / guide which describes the process?

Devise secret_key missing from documentation.

From here: http://doc.locomotivecms.com/get-started/install-engine-locally#mac

bundle exec unicorn_rails
produces errors, specifically,

"undefined method `secret_key=' for Devise:Module (NoMethodError)"

I commented out the config.secret_key in config/initializers/devise.rb, and the unicorn_rails works now, but this seems like an important step that wasn't mentioned in documentation.

How important is this secret_key, and if it's not that important, does there need to be a "comment this out" step?

documentation for the (for loop)

{% for post in content_type.posts %} should we start using the content_type like in the new documentation or should we continue to use contents.posts

on header, the link "get started" is broken

(it points to www /tour)
I think the header has changed on the www site, not on the documentation site.

File types whitelist

If @did can confirm it's the right way of doing so, this should definitely be in the documentation, don't you think ?

https://groups.google.com/forum/?fromgroups#!topic/locomotivecms/r7f-54gSg0U

'bundler' gem appears to be a dependency not specified in blog tutorial ?

Apologies as I am new to ruby so this might be evident to someone else. Working through the blog tutorial and I:

installed XCode
verified that ruby was at 2.0.0 (my default from OSX)
installed wagon

After which I ran:

$ wagon init blog . -t bootstrap3

At the end of the installation process I got the error:

 run  bundle install
/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/lib/ruby/2.0.0/rubygems.rb:269:in `bin_path': can't find gem bundler (>= 0) (Gem::GemNotFoundException)

I "solved" this by running gem install bundler in the working directory; I'm not sure if this is an ideal solution but allowed me to finish the install. Only posting here in case someone who knows more about Ruby gems can indicate whether this was particular to my setup or something that might affect all new mac users (in which case a note in the first section of the tutorial might be nice).

Thanks a tonne either way. LocomotiveCMS looks awesome.

Left sidebar doesn't slide down all the way

When you scroll down on a page, the sidebar doesn't slide down all the way. The top of the sidebar remains hidden behind the top bar.

new liquid tag: model_form

[Filter] encode

description of the encode filter

Wrong deployment instruction

hey Jeremie,

In this page, http://doc.locomotivecms.com/guides/get-started/deployment, the command to deploy is not right.

It should be: bundle exec wagon push staging --resource=all

thanks !

The wizard is not present at localhost:8080

The guide says one should start the server and

open localhost:8080

But there is no wizard there:

Startsidens innholds This is the content for the homepage

The routes mounts locomotive at /locomotive. When visiting /locomotive I'm asked for u/p. Is the doc outdated or have I skipped a step?

I've created a github repo from my newly initialized project, please have a look: https://github.com/stabenfeldt/LocomotiveCMS

[redesign] Documentation does not execute or render pages correctly

As stated in the README.md we are to run bundle install and then bundle exec wagon serve.

However all pages are rendering with errors and or call stack. With the header of the page being.

NoMethodError at /
undefined method `+' for nil:NilClass

See image here. https://drive.google.com/file/d/0B3qb_Ex49jJ3alJfZU9qQUU2YkE/edit?usp=sharing

New tag to document: link_to

locomotivecms/engine#507

404 for liquid syntax link

The templating basics page gives a link to liquid syntax. That link is a 404.

http://doc.locomotivecms.com/guides/templating/liquid_syntax

No description about current_user drop

sad

Broken link to image new_york_at_night.jpg

In the section /making-blog/3-4-content-type-templates there is a link to an image called new_york_at_night.jpg that goes to a 404 page.

[Missing] random filter

No font caching at all

http://doc.locomotivecms.com/ loading/rendering is really slow because every request downloads all fonts from scratch (1MB)

Tested on latest chrome and firefox

modulo filter description is wrong

http://doc.locomotivecms.com/references/filters/misc/modulo we have str_modulo instead of modulo.

Missing file in the making a blog section

section 3.1 - Adding Content Types: there is a link to a zip archive for placeholder images that is broken.

Style .alert messages

RSS feed example code truncated

You can only see the top half. Bottom half gets cut off.

Compare browser: http://doc.locomotivecms.com/faq/rss-feed

With source: https://github.com/locomotivecms/documentation/blob/master/app/views/pages/faq/rss_feed.liquid.haml#L35

Make wagon installation clearer for developers

There's a lot of text for beginners on the install wagon page, but really all experienced developers will care about is:

gem install locomotivecms_wagon

So maybe it should be bold. I'd say even mention it on top, replacing this:

Ruby veterans and experienced users may already have some or all of these dependencies installed, so feel free to skim.

With something like:

Ruby veterans and experienced users may already have some or all of these dependencies installed, so you might only need to run gem install locomotivecms_wagon

My initial thought was to run gem install wagon, but then I realized that was an entirely different thing, so then I had to look at your docs and the gem name didn't immediately stand out, which is annoying. 😞

Documentation for page generation is incorrect

Right now it says to generate a page using this command

bundle exec wagon generate your-page-slug

It should read:

bundle exec wagon generate page your-page-slug-or-fullpath

I can fix this later this weekend

redirect old template reference url

Locomotive cms help link links to the old page http://doc.locomotivecms.com/templates/basics , i think the new site should redirect this url to http://doc.locomotivecms.com/references for backward compatiblity

FAQ is down : Liquid error: undefined method `entries' for nil:NilClass

http://doc.locomotivecms.com/faq
You can see page title but not the FAQ content.

Find a solution for text highlighting

missing session_assign tag

Style tables

decent multisite documentation

no good documentation at the moment, its taking way to long to figure out how multisites work.

Locally how does one add a new site?
editing hostfile to have 127.0.0.1 cms.dev

Please address this lack in documentation, the cms looks promising.

Add documentation about the filters/tags from the liquid_extensions

Nokogiri issue?

Hi guys,

I'm working on your 'Getting Started' tutorial, and I am on the part where one runs bundle install after initializing the rails app and editing the Gemfile. When I try to do so, I get the following error:

An error occurred while installing nokogiri (1.5.11), and Bundler cannot continue.
Make sure that `gem install nokogiri -v '1.5.11'` succeeds before bundling.

I try out gem install nokogiri -v '1.5.11' and it works fine, but then I try bundle install/sudo bundle install again and it still returns the same error.

locomotivecms / documentation Goto Github PK

documentation's Introduction