Re: [Zotonic-Usr] Docs schedule? Discrepancies trying to get up & running

[Kunthar]

> 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-developers/P9bdANUOT6Y
> 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

please provide priv/sites/your_site/config here.

did you add your used ip to /etc/hosts ?

> - 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:
>
>> [igor@Igor-Clarks-iMac ~/Erlang/zotonic 551]$ find . -name default.erl
>> [igor@Igor-Clarks-iMac ~/Erlang/zotonic 551]$
>
> 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 :-(
>
> Best wishes,
> Igor



--
BR,
\|/ Kunthar

[Igor Clark]

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!

Thanks,

Igor

[Igor Clark]

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

[natxo cabre]

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>

[Igor Clark]

Thanks Natxo. Yes it looks excellent.

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.

Cheers,

Igor

[Kunthar]

No problem Igor.
Let us know when you have a problem again.

--
BR,
\|/ Kunthar

[Andreas Stenius]

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.

I'd also like to mention that when you get a warning about a missing page dispatch rule, you most likely want to enable mod_base_site, as that module has the missing dispatch rule.

( https://github.com/zotonic/zotonic/blob/master/modules/mod_base_site/dispatch/dispatch )

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.

Cheers,

Andreas

2012/10/22 Kunthar <kun...@gmail.com>