I've just downloaded Zotonic from the Github repo and started following the install instructions from the site. After only 3 or 4 steps there are several discrepancies between what I find in the software and what's in the install. E.g.:
- you have to run bin/zotonic start in order to run bin/zotonic addsite - ok, easy step, but not clear at all from http://zotonic.com/install - when you get it running and use "start.sh" there's constant warnings on the console saying "Failed to get page url path. Is the `page' dispatch rule missing?". I searched the Google group and found https://groups.google.com/forum/?fromgroups=#!topic/zotonic-developer... which says that dispatch rules are missing, but doesn't seem to correlate with the fact that there's already a dispatch/dispatch file in the site I just created, with different contents - trying to follow http://zotonic.com/documentation/801/working-with-sites you find the instruction "3) Copy the default.erl file from the default site as well", but there's no "default.erl" anywhere in the installation:
These seem like fairly fundamental things, so I just wonder - am I missing something, or looking at the wrong docs? Has there maybe just been a release of the software which the docs haven't been updated to reflect yet? Are the docs going to get up to date with this or will things change again soon?
I'd love to get started throwing some proper time into this, as I can see from the modules and examples that there's a lot of excellent stuff to get to grips with - but at the moment it seems like the basics are going to take some wrestling :-(
> I've just downloaded Zotonic from the Github repo and started following the
> install instructions from the site.
Which branch you have checked out?
Did you checked out this: release-0.8.x
>After only 3 or 4 steps there are several discrepancies between what I find in the software and what's in the
> install. E.g.:
> - you have to run bin/zotonic start in order to run bin/zotonic addsite -
> ok, easy step, but not clear at all from http://zotonic.com/install > - when you get it running and use "start.sh" there's constant warnings on
> the console saying "Failed to get page url path. Is the `page' dispatch rule
> missing?". I searched the Google group and found
> https://groups.google.com/forum/?fromgroups=#!topic/zotonic-developer... > which says that dispatch rules are missing, but doesn't seem to correlate
> with the fact that there's already a dispatch/dispatch file in the site I
> just created, with different contents
> - trying to follow http://zotonic.com/documentation/801/working-with-sites > you find the instruction "3) Copy the default.erl file from the default site
> as well", but there's no "default.erl" anywhere in the installation:
> These seem like fairly fundamental things, so I just wonder - am I missing
> something, or looking at the wrong docs? Has there maybe just been a release
> of the software which the docs haven't been updated to reflect yet? Are the
> docs going to get up to date with this or will things change again soon?
> I'd love to get started throwing some proper time into this, as I can see
> from the modules and examples that there's a lot of excellent stuff to get
> to grips with - but at the moment it seems like the basics are going to take
> some wrestling :-(
On Monday, October 22, 2012 5:19:59 PM UTC+1, Kunthar wrote:
> Which branch you have checked out? > Did you checked out this: release-0.8.x
I just followed the instructions on http://zotonic.com/download and did git clone git://github.com/zotonic/zotonic.git
> please provide priv/sites/your_site/config here.
It's exactly as generated by bin/zotonic addsite except that:
> did you add your used ip to /etc/hosts ?
No, I changed the config file to have {hostname, "localhost:8000"}.
Thanks very much for your responses - however I'm less trying to work through every individual issue, and more asking whether there are changes pending in documentation, as I'm literally following the steps on the site verbatim, and coming up with errors, which is off-putting for newbies like me!
Ah - I think I misunderstood! Got the release-0.8.x branch from github now and trying that out with much more success. Thanks. Even if it took me a couple of readings to work it out, and even if I missed where it says "Git repo is latest-and-greatest" ;-)
On Monday, October 22, 2012 5:26:01 PM UTC+1, Igor Clark wrote:
> Hi there, thanks
> On Monday, October 22, 2012 5:19:59 PM UTC+1, Kunthar wrote:
>> Which branch you have checked out? >> Did you checked out this: release-0.8.x
> I just followed the instructions on http://zotonic.com/download and did > git clone git://github.com/zotonic/zotonic.git
>> please provide priv/sites/your_site/config here.
> It's exactly as generated by bin/zotonic addsite except that:
>> did you add your used ip to /etc/hosts ?
> No, I changed the config file to have {hostname, "localhost:8000"}.
> Thanks very much for your responses - however I'm less trying to work > through every individual issue, and more asking whether there are changes > pending in documentation, as I'm literally following the steps on the site > verbatim, and coming up with errors, which is off-putting for newbies like > me!
I'm also a newbie and I encountered the same issues when I followed the
steps in http://zotonic.com/documentation/801/working-with-sites. So,
answering your question I think "yes", there are changes pending in the
documentation.
That said, I think it's worth investing your time in this project: the core
team is really-really responsive, the community is small but welcomed and
the project seems very well-tought-out.
> On Monday, October 22, 2012 5:19:59 PM UTC+1, Kunthar wrote:
>> Which branch you have checked out?
>> Did you checked out this: release-0.8.x
> I just followed the instructions on http://zotonic.com/download and did
> git clone git://github.com/zotonic/zotonic.git
>> please provide priv/sites/your_site/config here.
> It's exactly as generated by bin/zotonic addsite except that:
>> did you add your used ip to /etc/hosts ?
> No, I changed the config file to have {hostname, "localhost:8000"}.
> Thanks very much for your responses - however I'm less trying to work
> through every individual issue, and more asking whether there are changes
> pending in documentation, as I'm literally following the steps on the site
> verbatim, and coming up with errors, which is off-putting for newbies like
> me!
I got things working a bit better after I went back and checked out the release-0.8.x branch according to Kunthar's advice. However like you say there are still incongruencies from the working-with-sites page, like for example there's still no "default.erl" anywhere in the installation.
I'm just really interested to know when the 0.9 branch is going to be released with documentation. From what I saw trying it out earlier, it's significantly advanced over 0.8, and unless I'm mistaken again, I think there are modules in 0.9 which will make it even better, like the twitter streaming stuff for example.
On Monday, October 22, 2012 6:01:54 PM UTC+1, natxo cabré wrote:
> Hi Igor,
> I'm also a newbie and I encountered the same issues when I followed the > steps in http://zotonic.com/documentation/801/working-with-sites. So, > answering your question I think "yes", there are changes pending in the > documentation.
> That said, I think it's worth investing your time in this project: the > core team is really-really responsive, the community is small but welcomed > and the project seems very well-tought-out.
> Let me know if I can help you.
> regards,
> Natxo
> 2012/10/22 Igor Clark <igor....@gmail.com <javascript:>>
>> Hi there, thanks
>> On Monday, October 22, 2012 5:19:59 PM UTC+1, Kunthar wrote:
>>> Which branch you have checked out? >>> Did you checked out this: release-0.8.x
>> I just followed the instructions on http://zotonic.com/download and did >> git clone git://github.com/zotonic/zotonic.git
>>> please provide priv/sites/your_site/config here.
>> It's exactly as generated by bin/zotonic addsite except that:
>>> did you add your used ip to /etc/hosts ?
>> No, I changed the config file to have {hostname, "localhost:8000"}.
>> Thanks very much for your responses - however I'm less trying to work >> through every individual issue, and more asking whether there are changes >> pending in documentation, as I'm literally following the steps on the site >> verbatim, and coming up with errors, which is off-putting for newbies like >> me!
On Mon, Oct 22, 2012 at 7:51 PM, Igor Clark <igor.cl...@gmail.com> wrote:
> Ah - I think I misunderstood! Got the release-0.8.x branch from github now
> and trying that out with much more success. Thanks. Even if it took me a
> couple of readings to work it out, and even if I missed where it says "Git
> repo is latest-and-greatest" ;-)
> My fault - sorry, and thanks for your help.
> Best
> Igor
> On Monday, October 22, 2012 5:26:01 PM UTC+1, Igor Clark wrote:
>> Hi there, thanks
>> On Monday, October 22, 2012 5:19:59 PM UTC+1, Kunthar wrote:
>>> Which branch you have checked out?
>>> Did you checked out this: release-0.8.x
>> I just followed the instructions on http://zotonic.com/download and did
>> git clone git://github.com/zotonic/zotonic.git
>>> please provide priv/sites/your_site/config here.
>> It's exactly as generated by bin/zotonic addsite except that:
>>> did you add your used ip to /etc/hosts ?
>> No, I changed the config file to have {hostname, "localhost:8000"}.
>> Thanks very much for your responses - however I'm less trying to work
>> through every individual issue, and more asking whether there are changes
>> pending in documentation, as I'm literally following the steps on the site
>> verbatim, and coming up with errors, which is off-putting for newbies like
>> me!
I just want to say thank you to every one helping out.
We are working hard to improve the documentation and get it up-to-date.
Most of the existing documentation has already been migrated, and work is
under way to cover more zotonic ground, as well as improved installation
and getting started documentation.
The work in progress is available from zotonic.com/docs/ for anyone trying
out the 0.9-dev version.
Or add some page dispatch rules to your own site's dispatch file, if you
don't want to enable mod_base_site.
The page dispatch rule is used as a "last resort" when determining the URL
for a resource.
> No problem Igor.
> Let us know when you have a problem again.
> On Mon, Oct 22, 2012 at 7:51 PM, Igor Clark <igor.cl...@gmail.com> wrote:
> > Ah - I think I misunderstood! Got the release-0.8.x branch from github
> now
> > and trying that out with much more success. Thanks. Even if it took me a
> > couple of readings to work it out, and even if I missed where it says
> "Git
> > repo is latest-and-greatest" ;-)
> > My fault - sorry, and thanks for your help.
> > Best
> > Igor
> > On Monday, October 22, 2012 5:26:01 PM UTC+1, Igor Clark wrote:
> >> Hi there, thanks
> >> On Monday, October 22, 2012 5:19:59 PM UTC+1, Kunthar wrote:
> >>> Which branch you have checked out?
> >>> Did you checked out this: release-0.8.x
> >> I just followed the instructions on http://zotonic.com/download and did
> >> git clone git://github.com/zotonic/zotonic.git
> >>> please provide priv/sites/your_site/config here.
> >> It's exactly as generated by bin/zotonic addsite except that:
> >>> did you add your used ip to /etc/hosts ?
> >> No, I changed the config file to have {hostname, "localhost:8000"}.
> >> Thanks very much for your responses - however I'm less trying to work
> >> through every individual issue, and more asking whether there are
> changes
> >> pending in documentation, as I'm literally following the steps on the
> site
> >> verbatim, and coming up with errors, which is off-putting for newbies
> like
> >> me!
