The forum operates in read-only mode. Please head to StackOverflow for support.

Sun, 08/14/2011 - 22:37

ckeric

Joined: 14/08/2011

Posts: 4

So how to get started?

I'm confused. Nothing in the documentation says how to get started. I've downloaded the file and set the ckeditor folder in my Apache document root. But now what? Everything else seems to be assuming a step I can't find described anywhere.

The Installation Guide says to check the installation by going to a _examples folder--but there is no _examples folder in the files I extracted from the download.

I would think to start with the User's Guide, but that shows an Interface without telling me where or how I get to that Interface. And the Developer's Guide shows some bits of code but doesn't explain what that code does (e.g., where does the textarea stuff you create in Complete Sample on the Integration Page go?) Nor does the Developer's Guide explain how that code relates to the Interface discussed in the Users' Guide.

What doesn't seem to be provided anywhere is the big picture. Say I've got a site, http://www.mysite.com. I want to use this editor to create some html code for the site. How do I do this? Do I put a textarea in one of the pages in the site? How do I move from inputting material to that textarea to having the material show on the site?

Maybe this is all explained somewhere, but I've spent a couple of hours poking around the ckeditor site and its support documents and haven't found my basic-type questions answered. Everything I've seen seems to assume those answer. Maybe I'm just stupid and it's obvious to everyone else?

Thanks.

Tue, 08/16/2011 - 15:30

Anna

Joined: 14/12/2010

Posts: 1369

Re: So how to get started?

Are you sure you read the Installation article that is linked on the Download page? Is this information enough or do you still find it unclear as to how to proceed?

There is no "_examples" folder, you should check your installation for the "_samples" folder instead.

Documentation Manager, CKSource

See CKEditor 5 docs, CKEditor 4 docs, CKEditor 3 docs, CKFinder 3 docs, CKFinder 2 docs for help.
Visit the new CKEditor SDK for samples showcasing editor features to try out and download!

Fri, 08/19/2011 - 17:27

ckeric

Joined: 14/08/2011

Posts: 4

Re: So how to get started?

I meant to say "_samples." Among the files I extracted (from "ckeditor_3.6.2.zip") there are no files that start with an underline.

So my questions remain. All the installations document says is to download and extract. Then it says to check the install from a browser by invoking a page that doesn't seem to exist (_samples/index.html). The instructions in the User's Guide and Developer's Guide seem to assume that one has the app running, but that's just my problem. How do I start the app?
-If I try "localhost/ckeditor" I get a set of "samples" that don't tell me where or how I use the samples or how I integrate them into a web site.
-Your page "http://cksource.com/ckeditor" shows an interface that I haven't found any way to bring up. Same for the ckeditor.com/demo page.

So how do I get to that editing interface? And, again, how does it integrate into a website? These steps may be something so obvious to the team that you're not aware of it, but it's not obvious to me for some reason.

[Edit: there are two files starting with underscore, _translationstatus.txt and _posteddata.php. But there is no folder starting with underscore.]

Fri, 08/19/2011 - 17:51

born2see

Joined: 19/08/2011

Posts: 2

Re: So how to get started?

I am having the same problem. How do I begin to edit a page on my website? I installed ckeditor in the root of my site. To test the editing I copied a sample page to the _samples directory and opened it. But all I see is the page, no editor.

Unfortunately nowhere in your docs does it say how to open a page for editing.

Thank you

Fri, 08/19/2011 - 20:13

Anna

Joined: 14/12/2010

Posts: 1369

Re: So how to get started?

Guys, I am beginning to wonder what it is that you are downloading...

Go to http://ckeditor.com/download, click "Download ZIP" to get this file: http://download.cksource.com/CKEditor/C ... _3.6.1.zip (CKEditor 3.6.1 at the moment.)

Save to your local disk. Unpack it, it contains the "ckeditor" folder. Copy the whole "ckeditor" folder to your server (might be the local one like Apache). Depending on the address and configuration of your Apache server, you will need to open something like http://localhost/ckeditor/_samples/index.html

You should get a page with links like this one at our nightly builds server: http://nightly.ckeditor.com/7212/_samples/

Click the links to open the samples. CKEditor should load in all of them, with different configurations and options activated, just like in the nightly build demos.

Documentation Manager, CKSource

See CKEditor 5 docs, CKEditor 4 docs, CKEditor 3 docs, CKFinder 3 docs, CKFinder 2 docs for help.
Visit the new CKEditor SDK for samples showcasing editor features to try out and download!

Fri, 08/19/2011 - 20:59

born2see

Joined: 19/08/2011

Posts: 2

Re: So how to get started?

Anna,

I've done all that and the sample page loads just like it should.

Now how do I edit one of the real pages in my website? I copied a page from my site to the .../_samples directory. Pointed my browser(Firefox) at it and loads the page but no toolbar with which to edit it.

That's the problem.

D

Fri, 08/19/2011 - 21:01

ckeric

Joined: 14/08/2011

Posts: 4

Re: So how to get started?

You're just repeating what we've already read and referenced.

I downloaded that file, extracted the files. There is no _samples/index.html folder.

The localhost/ckeditor returns the same samples on the nightly page you mention. But they do not answer my question. For example, "create ckeditor instances in php" does not bring me to the editing interface. It just opens a simple webpage with a text area and a submit button. But that's not what I'm looking for. There's not even any explanation of what that does when I hit the submit button. It certainly doesn't create any formatted html on the web page.

Here's the code I used. The resulting page image in attached. This doesn't look anything like your Little Red Riding hood example. SO WHAT AM I MISSING?

<html><head></head><body>   
  <form method="post">
      <p>
         My Editor:<br />
         <textarea id="editor1" name="editor1"></textarea>
      </p>
      <p>
         <input type="submit" />
      </p>
   </form>
<?php
include_once "ckeditor/ckeditor.php";
// Create a class instance.
$CKEditor = new CKEditor();
// Path to the CKEditor directory.
$CKEditor->basePath = '/ckeditor/';
// Create a textarea element and attach CKEditor to it.
$CKEditor->editor("editor1", "This is some sample text");
?>
</body></html>

Attachments:

Attachment	Size
screenshot_5.png	72.37 KB

Fri, 08/19/2011 - 21:16

alfonsoml

Joined: 31/12/2006

Posts: 3737

Re: So how to get started?

If you don't get a _samples folder, then something is wrong with whatever program you're using to extract the zip. The fact that you get the list of samples when you load /ckeditor means that probably all the files have been extracted there and so the structure has been lost and it can't work.

Besides that, I think that CKEditor is not what you are searching for according to your questions. Please read this: http://alfonsoml.blogspot.com/2009/08/u ... sites.html

Fri, 08/19/2011 - 22:48

ckeric

Joined: 14/08/2011

Posts: 4

Re: So how to get started?

Interesting--when I unzipped from the command line I got a bunch of directories along with a bunch of files. When I previously unzipped using the "extract" command from Nautilus, Nautilus apparently pulled everything out of their sub-directories. So this goes part way towards getting me going.

The blog you directed us to is also very helpful in providing some bigger picture on how the app works. It would be useful if that information were included in the app documentation.

Thanks. We'll see how it goes from here.

Wed, 08/24/2011 - 01:18

#10

skippyjet

Joined: 23/08/2011

Posts: 1

Re: So how to get started?

I have the same basic question about getting started.

I have installed ckeditor and the sample code seems to work fine, but what is the publishing process that is referenced on http://ckeditor.com/what-is-ckeditor?

I can create a new page with the editor and the toolbar interface, no prob, but how then do I publish a page with that ckeditor-created content, but without the toolbar?

Thanks

Wed, 09/14/2011 - 00:58

#11

writerguyfl

Joined: 14/09/2011

Posts: 1

Re: So how to get started?

I think the issue some experience is that there's doesn't appear to be any documentation (at least that I could find) on how to connect CKEditor with an existing data source (like mysql). Pointing people to the php folder in the _samples folder isn't helpful if people don't understand how to grab the $initialValue from a database and how to store the new value.

I used FCKEditor on a site years ago, so I'm sure I will be able to figure out what I need. But, I'm guessing many people will abandon CKEditor because they don't want to search through the sample files to figure out exactly how it work.

Finally, this post isn't a criticism of anyone involved in this project. I'm simply pointing out that what be obvious for one person (the php statements to get CKEditor data into a database, for example) might not be obvious to someone who has never seen the CKEditor code before.

Wed, 11/16/2011 - 04:02

#12

jovial.shilpa

Joined: 29/09/2011

Posts: 13

Re: So how to get started?

Hey
Include this in head --> <script type="text/javascript" src="ckeditor/ckeditor.js"></script>
and this in body --> <textarea id="editor1" class="ckeditor" name="editor1"> Sample data </textarea>

Hope this helps

Wed, 11/16/2011 - 11:04

#13

tony_c

Joined: 15/11/2011

Posts: 10

Re: So how to get started?

I'm still fairly new to CKEditor and CKFinder and I must say this is a problem I'm finding to be increasingly frustrating. The documentation seems to explain a lot, but not the basics, of which the writers of the documentation seem to have taken for granted that everyone should be able to figure it out. The documentation could do with a serious overhaul with a user with no experience of CKEditor/Finder in mind when writing it.

Mon, 12/19/2011 - 15:43

#14

Anna

Joined: 14/12/2010

Posts: 1369

Re: So how to get started?

Hi Tony,

thanks for your feedback. Anyone willing to review our documentation is most welcome to do it! Just send me a private message through the forum and we can discuss the most suitable method to do so. Any input will be greatly appreciated!

Documentation Manager, CKSource

See CKEditor 5 docs, CKEditor 4 docs, CKEditor 3 docs, CKFinder 3 docs, CKFinder 2 docs for help.
Visit the new CKEditor SDK for samples showcasing editor features to try out and download!

Mon, 04/01/2013 - 13:48

#15

xmikex

Joined: 01/04/2013

Posts: 1

it is not possible for

it is not possible for someone w/o deep knowledge how this tool works to start using it.

Please include in documentation a simple howto's how to edit existing index.html/php on someone website

Samples included are not for beginners, nowhere is to find a expels for OP questions.

I tried the replacebycode.html but there are few files included, it will be simple to include a example where a replacebycode.html will edit a index.php in web root.