Incorrect Terminology for Installing on a Mac

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

Hi :slight_smile:

Gedit colour codes the both the html and the css. If i hover over an open
coding bracket <smile> then it highlights the corresponding closing bracket
</smile>. I don't know what it does if there isn't a closing bracket.
Something for me to check! :slight_smile: It doesn't tell me what to write or give me
look-up tables or drop-down lists of possible tags/coding but i use w3schools or
look-up tables from elsewhere if required.

I think i should check out your suggestions to see if they do give extra
functionality. Even if they don't it would be interesting to see if they do
help me. Thanks for the suggestions :slight_smile:

Regards from
Tom :slight_smile:

Another important consideration would be to get into the habit of employing the free XHTML and CSS validators online at W3C (or its several mirrors)--either for code on a computer file on your machine or for actual hosted code. Typical webpages could literally contain several hundred instances of invalid code, which different browsers might interpret differently .

Gary

I have modified the text and (I think) repositioned the pictures. The result
has been submitted for publication. I assume someone with "publish"
permission will deal with it.

I'm not entirely happy with the way it came out, but I ran out of time to
try to figure out how to deal better with the pictures. Although I looked at
the code used on the Windows page, which is different from that used on the
Mac page, I didn't attempt to make major changes; I'd need to do more study
and fiddling to understand it well enough to do that. Also, I didn't add all
the pictures I had in my document, because I didn't have time to study the
page about uploading and dealing with pictures, and those pictures were not
essential to the instructions. I think they are nice-to-haves for new Mac
users.

Having done this page, I don't think I will get very involved in website
work. Learning to use Silverlight AND Alfresco AND LibreOffice itself is
overloading my brain. :wink: So I'll concentrate my limited time and brainpower
on the user guides and only jump into website work occasionally to help on
specific needs.

Hal

Published.

I am currently in the process of learning SilverSTRIPE myself.
(Silverlight is a MS product), so things can take a little time for me
to get done.
If you ever want to contribute anything without having to deal with
the confusing website back end, you can email the list or me directly
if you wish.

Thanks for the great work with the improvement,
Michael Wheatland

Hi Hal, Jeremy :slight_smile:

I upgraded your permissions to Publisher. When you feel your content
is ready, you can publish straight to the Web.

@Hal: a possible to-do: You worked on compiling a book of the Getting
Started Guide. I still haven't had time to post that in the docs
section at http://www.libreoffice.org/get-help/documentation/

Do you feel like doing that? I won't have much time over the next
couple of days, but could do so beginning of next week, if not.

As the guy on the team with most time spent using SilverStripe, I'll
have a look at your Mac instructions and see if I can help out with
any improvements to the formatting, and post the rest of your
screenshots.

As from next week, I plan to spend a lot more time working with you
guys on documentation.

David Nelson

> Having done this page, I don't think I will get very involved in website
> work. Learning to use Silverlight AND Alfresco AND LibreOffice itself is
> overloading my brain. :wink: So I'll concentrate my limited time and
brainpower
> on the user guides and only jump into website work occasionally to help
on
> specific needs.

SilverSTRIPE ...
(Silverlight is a MS product)...

<chuckle> Brain-fingers disconnect at whatever early hour I typed that.

If you ever want to contribute anything without having to deal with
the confusing website back end, you can email the list or me directly
if you wish.

Thanks, I may do that. We'll see how much time I have to even look at the
website, before I think about changes.

Hal