[WIKI] How To Blog about phile

[NeoBlack]

@james2doyle would you write this howto? I am not using the blogging feature :D

[Snip1]

Is there more info coming to that page, @james2doyle? I'll work on it with you, if you'd like. I'm not able to get blogging going atm based on that page and your prior assistance, and I sure would like to. If you can walk me through it, I will document it for that page.

[james2doyle]

I have actually already started. https://github.com/PhileCMS/Phile/wiki/How-To-Blog

[james2doyle]

If you want to continue that it's no problem

[Snip1]

On 2013-11-09, at 3:28 PM, James Doyle wrote:

I have actually already started. https://github.com/PhileCMS/Phile/wiki/How-To-Blog

I saw the page already, and thanks for getting it going. However, I am not yet able to kickstart the whole blogging thing based on that data, and copy/pasting from Pico hasn't been successful yet either... which may be because I am not selecting enough or the right items.

In any event... I'd be happy to work with you on this, and then document the process.

[Snip1]

Hehe... "work with you" is probably a pretty significant misnomer. My level of cluedness on this system is sufficiently limited that my enabling input would end up being pretty minimal... but I'm willing to do the work.

The advantage, of course, is that by the time I get it going, I will be able to describe it from a relatively n00besque perspective (making fewer assumptions on the readers' abilities), which might end up being a good thing, eh?

[james2doyle]

Yeah that sounds fair. Well when I am done it, you can review with a fresh
install and let me know if everything works

On Saturday, November 9, 2013, Snip1 wrote:

Hehe... "work with you" is probably a pretty significant misnomer. My
level of cluedness on this system is sufficiently limited that my enabling
input would end up being pretty minimal... but I'm willing to do the work.

The advantage, of course, is that by the time I get it going, I will be
able to describe it from a relatively n00besque perspective (making fewer
assumptions on the readers' abilities), which might end up being a good
thing, eh?

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/18#issuecomment-28136304
.

James Doyle

t: @james2doyle https://twitter.com/james2doylew: ohdoylerules.com
http://ohdoylerules.com

[james2doyle]

@Snip1 please check out the wiki on a fresh install of Phile and see you can get the blog roll going

https://github.com/PhileCMS/Phile/wiki/How-To-Blog

[Snip1]

On 2013-11-10, at 7:31 PM, James Doyle wrote:

please check out the wiki on a fresh install of Phile and see you can get the blog roll going

Thanks, James.
OK. So far, no joy. Here's what I did:

*D/L'ed a fresh copy of Philo and loaded it. It works fine.
*Added a post1.md with a date field in the header... it works fine, and shows up in the nav.
*Added your meta data to the above post1.md. Still works fine.

• Added the revamped code that strips dated posts out of the nav... works fine.

But that is where "works" stops. I have no way of accessing the blog post. I tried creating a post.html file in the default template folder... it won't load by direct url (my_philo_url/post.html) OK... so I added the 'blog roll' code (below the revamped nav code) into the new post.html, replacing the {{ content }} tag with that complete block of code. Does nothing. OK... so tried adding it to the template index.html file instead. The page loads, but with no content apart from the header and footer.

Where'd I go wrong?

[james2doyle]

Well the name of the page is going to be post1 in this example. post.html in the theme directory would be a layout, it isn't going to load by direct url unless you put the full path to the theme directory.

So where does my_philo_url/post1 go?

[Snip1]

On 2013-11-10, at 8:40 PM, James Doyle wrote:

So where does my_philo_url/post1 go?

OK.. it got a bit weird there for a while. I suspect caching issues were messing with me... but I've gotten past that.

Anyhow: I now have a clean template>default>index.html, and still have post.html as described earlier. And it works if I enter the url to the blog post directly... and indeed loads the post.html file (I know that because it has the modified nav block) So, things ARE starting to work!

What (if anything) are your next steps going to be, James? My short-term wish-list would have the blog posts be on the front page, showing 5 excerpted blog posts (and I have some ideas on that as well), as well as pagination. Is any of that on your radar? As it stands now the blog posts are invisible from an automated perspective, which is not really the idea, right?

[james2doyle]

@Snip1 how do you blog on Pico right now?

[Snip1]

@james2doyle I don't. Using WP if/when I blog ATM, which has been infrequent of late as that is no longer a workflow I enjoy... hence my interest in Pico in the first place, and now in Phile.

[james2doyle]

Ok well they are essentially the same idea. You leave the posts out of the nav and you have a section on the page that shows a loop of the posts. Have you got to the section in the wiki about "the loop"?

[Snip1]

On 2013-11-10, at 10:51 PM, James Doyle wrote:

Have you got to the section in the wiki about "the loop"?

Yes... I used that code in the post.html page (replacing {{ content }} ) to show the blog post when entering the direct URL. Does the same on the index, but then doesn't let the non-blog links in the nav show up.

[Snip1]

Till tomorrow, James. Thanks for your help this eve. I'm taking notes for the docs ;)

[james2doyle]

The post.html page should keep the {{ content }} in it. That's where the content of your post is going to be if you have set the template in the meta tags. The index page should have "the loop" on it and no meta template. That's where the list of posts will go.

It's all about the theme setup. There are no changes or updates that need to be made to Phile to make blogging possible. There are no next steps for blogging. A pagination plugin needs to be developed. But other than that, everything is there.

It seems like the easiest way to show how the blogging works, is to make a blog theme. Then there is no way to get something broken because it will come setup properly.

[Snip1]

@james2doyle : that's one way to go, and is the way Pico went with the "Pure" template. I've just posted a new thread wondering if perhaps there is another. #22

[james2doyle]

@Snip1 you keep saying that Phile has no blog. My site and @NeoBlack site both run Phile.

I suggest you read my comment again. Stop saying there is no blog feature or that it doesn't work. It works, you need a proper setup.

I am closing #22 because it contains more false information about how there is no blog in Phile.

[Snip1]

@james2doyle: I really don't understand what I perceive to be your hostility... I am certainly not looking to piss anyone off here.

You say, in your reply above, that "you need a proper setup". Exactly so. It is that 'proper setup' that is (currently, for me at any rate) elusive... and, I suggest, problematic. How can you say that I am disseminating "false information about how there is no blog in Phile" when the reality is that, in the default install, there indeed is no blog, and even with the advice you have given me to date, I still have no blog. So: not only is there no blog, but enabling one is not particularly trivial. The fact that you have one does nothing to ameliorate that.

Try not to take this quite as personally as it appears you are and take a look at it from a neophite perspective.

[Snip1]

and even with the advice you have given me to date,

Probably bad wording: more accurate would be 'my understanding of the advice you have given me to date'

[james2doyle]

I am not taking this personally, there is clearly an issue with the wiki. But blaming me for not being able to give you a blog is not that constructive.

We are trying to start a new project here, and when a user is creating issues and making comments that are false or misinformed, that hurts the public opinion and leads people to believe the system is flawed in some way.

Clearly the wiki was missing something for you, because you are saying I still have no blog, admitting that everyone else seems to be fine. I have linked you to my repo with my Phile blog on it. Have you looked at it? Or at least installed it on your system to see how the blog setup is made? If you want to get ahead of me updating the wiki or creating a blog theme, this would be the way.

As I mentioned in my previous comment, I am going to develop a theme that has a blog setup in it. Let me solve this issue in an alternative way to the wiki, and let me finish this solution before you complain that it doesn't work or things are still "broken".

I am having an intern at my office run through the wiki and he has pointed out some flaws that I can address. But ultimately a theme with a blog setup is probably the best.

[Snip1]

The post.html page should keep the {{ content }} in it. That's where the content of your post is going to be if you have set the template in the meta tags. The index page should have "the loop" on it and no meta template. That's where the list of posts will go.

To review where I am at so far:

*Clean install of Phile.
*Duplicate default theme > index.html and rename post.html
*Replace the default nav code on both pages with:

{# only show the pages that have no meta date #} 
<ul class="nav"> 
{% for page in pages %} 
{% if page.meta.date == null %} 
<li>
<a href="{{ page.url }}">{{ page.title }}</a>
</li> 
{% endif %} 
{% endfor %} 
</ul>

*In index.html above, replace {{ content }} with the "{# only show the pages that use a template" thru "{% endif %} {% endfor %}" loop code, verbatim.

*Blog .md files have this head:

/*
Title: Fake Blog Post
Description: This post is not real
Date: 2013/11/08
Category: PHP
Keywords: PHP, CMS, Phile, Markdown, Twig
Template: post
*/

*Non-blog .md files have this head:

/*
Title: Sub Page
*/

(Title and date variable above)

The result?

*The nav system works as expected: non-blog posts show, and blog posts do not.
*The index page displays a list of excerpted blog posts.
*Clicking on a blog post title goes to the actual post.
*Clicking on a nav link does nothing.
*Clicking on the site title returns to the index (blog post listings)

So... almost!

[Snip1]

On 2013-11-11, at 11:30 AM, James Doyle wrote:

But blaming me for not being able to give you a blog is not that constructive..

There is absolutely no 'blame', James. Trust me. I know my limitations, and have no doubt this is a me thing.

[Snip1]

I have linked you to my repo with my Phile blog on it. Have you looked at it? Or at least installed it on your system to see how the blog setup is made?

Yes... I tried that last week. I don't remember why, but it threw errors. If I recall, you are using a different markdown parser?

BTW: you mention that communicating this way may give visitors a bad impression. Fair enough. Is there an alternative? And: can posts/threads be deleted?

(Tho, I have to say: I might offer a contravailing opinion, that being that seeing us discussing this at length might well prove an encouragement. I know that for me, the downfall of Pico was the dead silence.)

[Snip1]

Wow.

[Snip1]

*Non-blog .md files have this head:

/*
Title: Sub Page
*/

Adding "Template: post" solves the issue... now it all seems to work. So EVERY .md file needs this meta, it appears.

[james2doyle]

Move issues and comments to https://github.com/PhileCMS/Phile-Blog-Theme