Google Groups

Re: userhelp.silverstripe.org content and User Guide PDF


DesignCity Mar 16, 2011 5:37 PM
Posted in group: SilverStripe Core Development
Simon - my understanding from previous requests for the Userhelp
content and assets is that you'll need to scrape it yourself from the
site.



On Mar 16, 4:52 am, "simon.wade" <simon.w...@gmail.com> wrote:
> I would also like to pick this up. I've been trying to contact Martijn
> to coordinate with him, but haven't been able to get a response. I
> need to get access to the content and assets for the userhelp website.
> We'll be using this to develop a PDF and we're happy to share this
> with the community. Specifically we'll be developing a 20-30 page PDF
> that covers only the basics of content editing, and will serve as a
> handover document that introduces a user to the CMS.
>
> This is now quite urgent so if someone can contact me with a database
> dump and an archive of the assets that'd be great. The source code to
> the current userguide site would also be very useful.
>
> On Mar 1, 9:14 am, Martijn Van Nieuwenhoven <marva...@gmail.com>
> wrote:
>
>
>
> > With the Notes button you can add personal notes to each page, which you van
> > print out/email on a seperate page. The notes are stored for 14 days since
> > last visit.
>
> > Since the target audience is the end CMS user and its not a Form/Blog, I
> > want to add a Feedback or 'Report an error' form, rather then a comment
> > system.
> > In that way pages stay clean and easy to read and important information does
> > not get lost in the comments.
>
> > But thats how I look at it.
> > In fact it should look like an online published Manual (from PDF) (but in
> > fact the opposite it true...)
>
> > On Mon, Feb 28, 2011 at 11:01 PM, Ingo Schommer <i...@silverstripe.com>wrote:
>
> > > Hey Martijn, the screenshots look promising!
> > > How does the notes feature work, is that an external service?
> > > We've typically applied Disqus comments for this purpose,
> > > although it needs careful moderation.
>
> > > On 1/03/2011, at 10:06 AM, Martijn Van Nieuwenhoven wrote:
>
> > > I have a basic 2.4.5 setup with only Page.php for the content, a FPDI/FPDF
> > > library and a custom Socialbar module for printing, emailing, sharing, add
> > > notes, add feedback.
>
> > > Attached I have the template I'm playing with and a sample PDF generated
> > > from the content (currently supports 3 levels deep) .
>
> > > Needs some finetuning, but I think its not bad for blueprint/playground.
>
> > > Martijn
>
> > > On Mon, Feb 28, 2011 at 9:02 PM, Ingo Schommer <i...@silverstripe.com>wrote:
>
> > >> Great Martin, let us know how you go!
> > >> Can you trial this with a standard SS install,
> > >> or do you need the source code for userhelp?
>
> > >> On 28/02/2011, at 11:52 PM, Martijn Van Nieuwenhoven wrote:
>
> > >> I would like to pick this up.
>
> > >> I have a simple PDF module, which can export simple HTML Pages to PDF
> > >> documents.
> > >> It allows to set a PDF as source file, so companies could create a branded
> > >> styled handover document from the online documentation.
> > >> This week the English userhelp is translated to Dutch and I will testdrive
> > >> a PDF export module.
>
> > >> If people want to join forces, let me know.
>
> > >> Cheers,
> > >> Martijn
>
> > >> On Mon, Feb 28, 2011 at 2:25 AM, Ingo Schommer <i...@silverstripe.com>wrote:
>
> > >>> On 28/02/2011, at 1:37 PM, simon.wade wrote:
>
> > >>> We're currently working out how to provide SS documentation to our
> > >>> clients. We'd like to put the userhelp.silverstripe.org content into a
> > >>> custom-built SS website that will also contain documentation specific
> > >>> to the client's system. Is it possible to get a database dump or some
> > >>> other import format for the userhelp.silverstripe.org content?
>
> > >>> Hmm, I think the easiest implementation for automatic download
> > >>> of content would be a RESTful API. It puts a bit more complexity
> > >>> in the download script on your end (following children references,
> > >>> downloading image assets). We can't really build a custom download
> > >>> script or PDF generation right now, everybody's tied up in SS3.
>
> > >>> Simon, if you need stuff right now I suggest you screen scrape the
> > >>> website
> > >>> (there's numerous tools out there, nothing SilverStripe specific).
> > >>> The content is Creative Commons licensed, so allows for this.
>
> > >>> We'd also like to have a 20-30 page PDF document that we can provide
> > >>> as a soft and hardcopy document at handover. I've noticed that this
> > >>> existed for 2.3, but I can't find it for 2.4. Also I'm not clear on
> > >>> the best way to produce a PDF from content on a website.
>
> > >>> This document was superseded by the userhelp.
> > >>> If anybody is willing to look into generating a clean PDF download
> > >>> from the userhelp, we could look into opensourcing the SilverStripe
> > >>> project
> > >>>  it runs on. The project is super simple, two PHP classes and a bit of
> > >>> styling.
> > >>> There's existing PDF generator modules for SilverStripe, although
> > >>> their quality is a bit poor. Before we spend the effort to opensource,
> > >>> any takers for this? The assumption is that you can take it to a
> > >>> sufficient quality standard that we can migrate the feature
> > >>> back into userhelp.
>
> > >>> It would be ideal if this process could be automated to some extent so
> > >>> that new versions can be created when the content on
> > >>> userhelp.silverstripe.org is updated.
>
> > >>> I think that having a really strong user guide will help to advance SS
> > >>> into the corporate market. Any help with this would be greatly
> > >>> appreciated.
>
> > >>> Thanks,
>
> > >>> Simon
>
> > >>> --
> > >>> You received this message because you are subscribed to the Google Groups
> > >>> "SilverStripe Core Development" group.
> > >>> To post to this group, send email to silverst...@googlegroups.com.
> > >>> To unsubscribe from this group, send email to
> > >>> silverstripe-d...@googlegroups.com.
> > >>> For more options, visit this group at
> > >>>http://groups.google.com/group/silverstripe-dev?hl=en.
>
> > >>> ---
> > >>> Ingo Schommer | Senior Developer
> > >>> SilverStripe
> > >>>http://silverstripe.com
> > >>> i...@silverstripe.com <andr...@silverstripe.com>
>
> > >>> Phone: <%2B64%204%20978%207330> <%2B64%204%20978%207330>+64 4 978 7330 x
> > >>> 42
> > >>> Skype: chillu23
>
> > >>> --
> > >>> You received this message because you are subscribed to the Google Groups
> > >>> "SilverStripe Core Development" group.
> > >>> To post to this group, send email to silverst...@googlegroups.com.
> > >>> To unsubscribe from this group, send email to
> > >>> silverstripe-d...@googlegroups.com.
> > >>> For more options, visit this group at
> > >>>http://groups.google.com/group/silverstripe-dev?hl=en.
>
> > >> --
> > >> You received this message because you are subscribed to the Google Groups
> > >> "SilverStripe Core Development" group.
> > >> To post to this group, send email to silverst...@googlegroups.com.
> > >> To unsubscribe from this group, send email to
> > >> silverstripe-d...@googlegroups.com.
> > >> For more options, visit this group at
> > >>http://groups.google.com/group/silverstripe-dev?hl=en.
>
> > >> ---
> > >> Ingo Schommer | Senior Developer
> > >> SilverStripe
> > >>http://silverstripe.com
> > >> i...@silverstripe.com <andr...@silverstripe.com>
>
> > >> Phone: <%2B64%204%20978%207330>+64 4 978 7330 x 42
> > >> Skype: chillu23
>
> > >> --
> > >> You received this message because you are subscribed to the Google Groups
> > >> "SilverStripe Core Development" group.
> > >> To post to this group, send email to silverst...@googlegroups.com.
> > >> To unsubscribe from this group, send email to
> > >> silverstripe-d...@googlegroups.com.
> > >> For more options, visit this group at
> > >>http://groups.google.com/group/silverstripe-dev?hl=en.
>
> > > --
> > > You received this message because you are subscribed to the Google Groups
> > > "SilverStripe Core Development" group.
> > > To post to this group, send email to silverst...@googlegroups.com.
> > > To unsubscribe from this group, send email to
> > > silverstripe-d...@googlegroups.com.
> > > For more options, visit this group at
> > >http://groups.google.com/group/silverstripe-dev?hl=en.
> > > <sample.pdf><sampleuserhelp.jpg>
>
> > > ---
> > > Ingo Schommer | Senior Developer
> > > SilverStripe
> > >http://silverstripe.com
> > > i...@silverstripe.com <andr...@silverstripe.com>
>
> > > Phone: +64 4 978 7330 x 42
> > > Skype: chillu23
>
> > >  --
> > > You received this message because you are subscribed to the Google Groups
> > > "SilverStripe Core Development" group.
> > > To post to this group, send email to silverst...@googlegroups.com.
> > > To unsubscribe from this group, send email to
> > > silverstripe-d...@googlegroups.com.
> > > For more options, visit this group at
> > >http://groups.google.com/group/silverstripe-dev?hl=en.