Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Loading…

What is the most impactful thing currently missing from DocPad? #415

Closed
balupton opened this Issue · 16 comments

10 participants

@balupton
Owner

Just as an experiment, what is the one feature/fix/documentation/whatever that is currently missing from DocPad that would bring the most impact to your life/business/work/whatever?

@DjebbZ

A build process for assets (js/css/images). Using Grunt for example.

@balupton
Owner

@DjebbZ there's https://gist.github.com/3898915 for that! Is that what you're after?

@DjebbZ

Yes. Having a real plugin or documentation for this snippet would be great. Thanks for the pointer !

@khrome83

Documentation needs to be improved across all plugins. I am about to post some issues I had to help improve there quality.

As far as new feature, the ability to create filter pages. I see it working SIMILAR to paged, but different.

The way I see it a site should be able to generate tags per document.
A unique list of tags would be used to generate a page for each, that filters the collection by the desired tag.
This allows users to click "apple" and see all documents that used "apple" as a Tag

I was thinking about how to tackle this myself, and thought that a layout would be set that would loop through the returned collection. Whatever page was generated would build a collection per a single tag. There would be 1 page generated for each unique tag across the whole site.

I would suggest there is also a param to determine where to drop these "tags" (/tags/) folder for example.

Ideally this would support clean URLs so apple would like to /tags/apple

A helper function would return the link, that users could apply to each tag in there tag cloud / list / block.

@getTagLink("apple")

I don't know if I am going to have the time to work on this, but this was one thing I was considering.

@khrome83

I was also considering writing a plugin to enable TypeScript.

http://www.typescriptlang.org/

@balupton
Owner

@DjebbZ cool, well post your suggestions on that gist, I'm sure someone will get to it when they can :)

@khrome83 definitely, creating document's dynamically generation is very important to me and is my current focus. The nativecomments and tumblr plugins showcase this, but right now they are quite experimental. I'd hope to get this done by the 18th, but we will see how time progresses :) But yeah, your plugin suggestion is quite nice - I think somewhere we may have a request for that somewhere in this issue tracker, but yeah would be a nice plugin to see and will be possible soon enough.

@ashnur

There are some parts of DocPad where the documentation could be improved by a lot. Like query-engine or bal-util. Maybe there are more, but the first is very scarce, demo is buggy iirc, and bal-util docs are just missing.

Having said that I think DocPad as a static page generator is done. I do not think, that it should be improved more in this direction, I think it's already perfect. Maybe adding source files programmatically could be improved, but that's actually just a convenience thing, which one can live with.

I can already setup a full website anywhere in minutes, with the best tools I can think of. Developing simple websites with DocPad is already extremely convenient and fast.

“Why is it necessary to spend six billion pounds speeding up the Eurostar train when, for a about 10 percent of that money, you could have top supermodels, male and female, serving free Chateau Petrus to all the passengers for the entire duration of the journey? You’d still have 5 billion left in change, and people would ask for the trains to be slowed down.” ― Rory Sutherland

So if you ask me what is the most "impactful" thing missing, I would say that I would like to have a DocPad which uses some speedy database to store the information about source documents, updates this documents when source files change, and has routes to this database to handle queries. Has a Users Management API with Authentication, and a Content Management API.

I am thinking of fast live queries in thousands of documents. Skipping the lengthy generation time for sites where there are hundreds of documents. Maybe it's too much, maybe this is not something you want from DocPad.

@hanjianwei

Docpad is already functional complete. More documents, more tests, fewer bugs for docpad & plugins. That's what I want.

@quesada
@DjebbZ

The other feature killer-feature I'm missing is a GUI. Having an admin gui for managing content automatically generated based on models and configuration, like the admin in Django (Python) or Symfony (PHP) would be awesome. It would allow me to safely give DocPad to clients. I know it's not a simple plugin but almost a whole project of its own, but it would place DocPad above all others static site generators.

@stevoland

Syndication feed support eg. atom + RSS (or did I miss something?)

@balupton
Owner

@stevoland sure! now if you mean creating a feed for your website, that's as easy as doing a content listing inside your feed file - example here: https://github.com/balupton/balupton.docpad/blob/master/src/documents/atom.xml.eco

if you mean importing feeds from other websites into your website, e.g. a twitter feed in the sidebar, see the feedr plugin

@stevoland

@balupton Aha! Thanks. I couldn't find any docpad sites that implemented it. Great - I'll definitely give docpad a spin soon. Looks great.

@segalr3

Hi,

  1. Admin Plugin
  2. Localization

Any progress with the above?
Great work so far!

@dospuntocero

+1 to segalr3.
a simple module to make forms on the front end (aka contact form)

@mikeumus
Owner

Closing. Discussions like this are now best handled by our daily catchups: bevry/meta#1

@mikeumus mikeumus closed this
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.