Incorrect Terminology for Installing on a Mac

So do you want me to give a polished version for the Linux install
instructions?

I could transform the wiki page into a formatted .odt for starters ...

Rogerio

Hi, :slight_smile:

So do you want me to give a polished version for the Linux install
instructions?

I could transform the wiki page into a formatted .odt for starters ...

Rogerio

It would cut out a conversion process if you could work directly on
the SilverStripe site. Would you be willing to do that?

David Nelson

I'm happy to help out as much as I can in my limited available time, and I
do speak HTML in case that helps. In addition to putting my Mac installation
instructions on the site, I noticed lots of minor copyediting things I can
fix up.

I've signed up, so when you get a chance you can give me author rights
there.

Hal

ok, I've registered. the Why? pages under the Home page sound great.

-- jdc

Yes, I have created the screenshots. Will implement very soon.

Hi Hal, :slight_smile:

I added you as author. Would you maybe like to work on your Mac
install instructions? They're up there now, but could do with a bit of
re-formatting...

David Nelson

Hi Jeremy, :slight_smile:

ok, I've registered. the Why? pages under the Home page sound great.

I added you as author. You don't think they need padding out a bit
with a *little* more text? I say that because search engine spiders
eat words and, unless you put at least a reasonable amount of content
on the page, they don't have material to index.

What are your thoughts about that? Although some comments at the
website confcall last night were that there's too much text on some
pages. Other people said that it's just that we need a good
page-setting job to be done, with some text going into boxes, with the
Design team providing graphics, Flash content, and other multimedia
content.

We certainly need more screenshots, too.

What do you think, guys?

In any case, I think it's a great thing for docs people to be closely
involved in work on the website content, because you have the writing
skills as well as good technical knowledge of the product.

David Nelson

The instructions I see on the website are not the ones I wrote. They are a
slightly edited version, with added screenshots, of the original
instructions. I assume this is the work Michael just did. Shall I replace
what's on that page with the instructions I wrote? Or what would you prefer?

Practical question: how do I actually get write access to the pages? Log in
somewhere (where?), then what? Are they editable online? Or what do I do?
Where can I find out what to do, and how to do it? I'm usually a quick study
if you point me in the right direction.

Hal

Hi Hal, :slight_smile:

My 2 cents would be that you should post the instructions you wrote, and replace
what's there.

To log in, go to http://libreoffice.org/admin

To help you get familiar with working with pages on SilverStripe:

1) SilverStripe demo site: http://demo.silverstripe.com/
2) General documentation on SilverStripe, the CMS used for libreoffice.org:
[1] http://en.wikipedia.org/wiki/SilverStripe
[2] http://en.wikipedia.org/wiki/SilverStripe#Documentation
[3] http://doc.silverstripe.org/
3) Documentation that will be especially useful to you when learning
to contribute work via the SilverStripe back-end:
[1] http://userhelp.silverstripe.org/for-website-content-editors/creating-and-editing-content/
[2] http://userhelp.silverstripe.org/for-website-content-editors/working-with-images-and-documents/

If you need any help from me, please do post back.

David Nelson

Sorry,
My mistake. I didn't go through and check the full instructions.
Making an assumption makes an ass out of ... well me.

Going back now.

Mike

The problems I am having with the Silverstripe editor is holding me
out from publishing your document fully.
As soon as someone who knows how Silverstripe works fixes this I will
publish your full document.

Sorry about the delay.

Mike

Hi Michael, :slight_smile:

As soon as someone who knows how Silverstripe works fixes this I will
publish your full document.

Maybe leave this to Hal? It's a great opportunity to get her actively
involved in the site content.

David Nelson

Not sure if you have noticed, but inserting images into the
Silverstripe TinyMCE editor is fundamentally broken.
I would suggest holding off on this until this is resolved by our
website administration brother(s) (read Christian).

Hi, :slight_smile:

Not sure if you have noticed, but inserting images into the
Silverstripe TinyMCE editor is fundamentally broken.
I would suggest holding off on this until this is resolved by our
website administration brother(s) (read Christian).

I've been working with it and I know the difficulties. One can fix
things manually by hitting the HTML editor button and then manually
editing the HTML (I do it in an external text editor personally, not
the browser window that opens).

David Nelson

Pardon, I meant the Why? pages sound great as a project to begin
working on. :smiley: The bullet points are nice, but there could be some
fluff. I'll mull it over and submit content over the next few days.

I'll take a look at the Silverstripe back-end and see what I come up
with.

-- jdc

Thanks for the warning. I generally much prefer to work in an HTML editor,
not a WYSIWYG editor, so I'll see how I go. :wink:

Hal

Hi Jeremy, :slight_smile:

Pardon, I meant the Why? pages sound great as a project to begin
working on. :smiley: The bullet points are nice, but there could be some
fluff. I'll mull it over and submit content over the next few days.

Cool, that's really great. :slight_smile:

I'll take a look at the Silverstripe back-end and see what I come up
with.

Good luck, buddy. :wink:

David Nelson

I use gedit (a text-editor) and switch from plain-text to html so that it all
gets colour-coded. Most text-editors (except Notepad) seem to offer the same
functionality. Does that count as an html editor?

Regards from
Tom :slight_smile:

Hi Tom, :slight_smile:

I use gedit (a text-editor) and switch from plain-text to html so that it all
gets colour-coded.  Most text-editors (except Notepad) seem to offer the same
functionality.  Does that count as an html editor?

I guess so... I do the same....

David Nelson

Probably not... You should employ an HTML editor that validates and simplifies coding for a number of common DOCTYPEs. There are plenty of them available. Try using the free (X)HTML editors from W3C or CoffeeCup Software. A decent editor also incorporates CSS for formatting.

Gary