Click here to Skip to main content
15,860,972 members
Articles / Programming Languages / Javascript

Offline Article Editor For CodeProject

Rate me:
Please Sign up or sign in to vote.
4.97/5 (78 votes)
15 Dec 2013CPOL4 min read 132.8K   4.2K   127   77
An offline wysiwyg editor to backup, edit or create new articles for CodeProject.

Having trouble writing or posting articles? These articles aim to gather together tips and tricks from authors and mentors to help you write great articles.

Contents

Introduction

CP Article Editor allows you to create/edit articles for CodeProject without internet connection requirement. You can also login to backup (both your articles and related images) and edit your published articles using this program. It is very small in size and portable. 

Screenshot of the main window. Browsing for an article to edit
(Click on the images to view the full sized images in a new window.)

Background

Let's learn or remember something that we will need to understand the source code.

Asynchronous Operations

Asynchronous operations work separately and they have their own threads. If we need to execute codes after they finished their works we can't write these codes below the method it starts them. Because they don't block the method they are called from. Another thing that we must know is that a thread can't access an object created on a different thread...

Generally we are using events for operations that must be done after an asynchronous method finished its mission or an event occured. But I used a different way for this purpose and I think it is relatively simpler to understand.

Suppose that we have a thread and we want to call a function after our thread finished its work:

C#
class Example
{
    private Action after_MyThreadFinished;
    private Form invoker;

    public Example(Action after_MyThreadFinished, Form invoker)
    {
        this.after_MyThreadFinished = after_MyThreadFinished;
        this.invoker = invoker;
    }

    public void doSomeWorksAsynchronously()
    {
        new Thread(() =>
        {
            // some codes that take long time...
            Thread.Sleep(2000);

            if (after_MyThreadFinished != null)
                invoker.Invoke(after_MyThreadFinished);
        }).Start();
    }
}

A thread can't make any change directly on a visual object owned by an UI thread. And we can't be sure about that the user will not use codes in our new thread to access visual controls created by the UI thread. This is why we need an invoker object. 

Usage:

C#
private void button1_Click(object sender, EventArgs e)
{
    Action myAction = new Action(() =>
    {
        MessageBox.Show("Finished.");
        this.Text = "I can access all the objects without any trouble." +
                    "Because I will be invoked by the thread of this form.";
    });

    Example example = new Example(myAction, this);
    example.doSomeWorksAsynchronously(); // It doesn't block the current thread.
}

CKEditor

CKEditor is an open source WYSIWYG editor that can be integrated with web pages easily. I used it inside a webbrowser in this project.

I customized the toolbar and removed unneccessary plugins to reduce total size. Additionally I modified image.js plugin to make using relative urls possible:

JavaScript
// Original code: B.preview.setAttribute('src',s.$.src);
// Modified for CP Article Editor
// The modification has been made to convert a relative image src to an
// absolute src in preview window.
// begin
if(s.$.src.substring(0,7)=='http://' || s.$.src.substring(0,8)=='https://')
    B.preview.setAttribute('src',s.$.src);
else
{
    var kok=(document.getElementsByTagName('base')[0]==null?'**biseyyapma**':
             document.getElementsByTagName('base')[0].getAttribute('href'));
    var verilenAdres=C;
    var tamAdres=kok+C;
    B.preview.setAttribute('src',tamAdres);
}
// end

// Original code: --
// Modified for CP Article Editor
// The modification has been made to convert an absolute image src to a relative src.
// begin
kok=(document.getElementsByTagName('base')[0]==null?'**biseyyapma**':
     document.getElementsByTagName('base')[0].getAttribute('href')),
D=(D.indexOf(kok)>-1?D.replace(kok,''):D),
// end

// Original code: C.data('cke-saved-src',D.getValue()); C.setAttribute('src',D.getValue());
// Modified for CP Article Editor
// The modification has been made to convert a relative image src to an absolute src.
// begin
var verilenAdres=D.getValue();
if(verilenAdres.substring(0,7)=='http://' || verilenAdres.substring(0,8)=='https://')
{
    C.data('cke-saved-src',D.getValue());
    C.setAttribute('src',D.getValue());
}
else
{
    var kok=(document.getElementsByTagName('base')[0]==null?'**biseyyapma**':
             document.getElementsByTagName('base')[0].getAttribute('href'));
    var tamAdres=(verilenAdres.indexOf(kok)<0?kok+verilenAdres:verilenAdres)
    C.data('cke-saved-src',tamAdres);
    C.setAttribute('src',tamAdres);
}
// end

Used configurations:

fullPage        : false  // We are not editing a full page
language        : 'en'   // I removed all other language files to decrease the size.
resize_enabled  : false  // Prevent resizing the editor.
uiColor         : '#CCC' // Grey
tabSpaces       : 4      // Each tab character is replaced with 4 spaces.
contentsCss     : 'CodeProject.css'  // CSS stylesheet file of codeproject template.
removePlugins   : 'contextmenu,liststyle,tabletools' // For hiding ckeditor's context menu
docType         : '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"' +
                  '"http://www.w3.org/TR/html4/loose.dtd">' // Document type of CodeProject.

Accessing And Modifying Elements Of An Html Document

I used a WebBrowser to login and extract required data. Here are some important methods.

Reading an attribute of an element:

C#
webBrowser.Document.GetElementById("IdOfTheElement").GetAttribute("attribute");

Changing an attribute of an element:

C#
webBrowser.Document.GetElementById("IdOfTheElement").SetAttribute("attribute", "new value");

Calling a javascript function that is inside a WebBrowser object from c#:

C#
object[] args = new object[] { ... };
object returned = webBrowser.Document.InvokeScript("functionName", args);

Downloading Files From A Website

There is a very simple method for downloading files from a website. I used that method to download images related with an article.

C#
WebClient webClient = new WebClient();
webClient.DownloadFile("http://www.site.com/file.extension", "C:\file.extension");

Disabling Click Sound In A WebBrowser

There isn't a property to disable the click sound in a web browser. But there is a way to do that using CoInternetSetFeatureEnabled API:

C#
static class ClickSoundDisabler
{
    // ---------------------------------------------------
    //  CodeProjectArticleEditor > ClickSoundDisabler.cs
    // ---------------------------------------------------
    //  CodeProject Article Editor
    //  Huseyin Atasoy
    //  September 2012
    // ---------------------------------------------------

    private const int FEATURE_DISABLE_NAVIGATION_SOUNDS = 21;

    private const int SET_FEATURE_ON_PROCESS = 0x00000002;

    [DllImport("urlmon.dll")]
    [PreserveSig]
    [return: MarshalAs(UnmanagedType.Error)]
    private static extern int CoInternetSetFeatureEnabled(int FeatureEntry,
        [MarshalAs(UnmanagedType.U4)] int dwFlags, bool fEnable);

    public static void disableClickSound()
    {
        try
        {
            CoInternetSetFeatureEnabled(FEATURE_DISABLE_NAVIGATION_SOUNDS,
                                        SET_FEATURE_ON_PROCESS, true);
        }
        catch{}
    }
}

Screenshots

This is the main window of the program:

Codeproject article editor main window

If you want to backup your published articles to edit or just to save them you can enter your email and password to login. Your articles will be listed after you logged in: 

Welcome after login

article list

When you choosed one of them, some informations about it will appear:

Informations about selected article

You can write a new article or edit an existing one even if you are not connected to the internet:

New article

Transferring Articles To CodeProject's Online Editor

  1. Select "Copy source to the clipboard" from the right-click menu.
    (Note that all absolute image paths are converted to relative paths. So you don't have to change anything on copied html codes.)
  2. Open codeproject online editor.
  3. Click on "HTML" button to switch to HTML mode:
    Image 8
  4. Paste your contents. (CTRL+V) 
  5. Click again on "HTML" button to switch back to design mode...

Points Of Interest

Let me list things that we can learn while examining the source codes:

  • WYSIWYG html editor in .NET.
  • How to use ckeditor in .NET?
  • How to call a javascript function inside a WebBrowser from a c# function?
  • Automated login and data extraction.
  • Using Actions instead of Events for asynchronous functions in c#.
  • Disabling click sound in a WebBrowser control.
  • Downloading files from internet in c#.

History

  • 15 December 2013 (v1.0.4) 
    • Article listing and login methods were fixed after some changes on CodeProject.
  • 4 April 2013 (v1.0.3)  
    • Logins have failed recently because of some updates on CodeProject. Fixed.  
    • Random strings were appended to the urls to force the WebBrowser to reload cached pages. 
  • 17 October 2012 (v1.0.2)
    • New codes to remember last browsed path 
    • A small change in extractMemberId() function
    • "Open with" support
      (You can use "Open with" menu or drag a cpa file and drop it on icon of the program.)
    • A unique file header to validate CPA (CodeProject Article) files
      (Because of that old cpa files cannot be opened with this version.)
  • 5 October 2012 (v1.0.1)
    • "ctl00" became "ctl01" on the login page of codeproject. So a new function (getElementId()) was written to get IDs of elements using Regex class and this function was used instead of all old constants that will be able to be changed by codeproject in future.
  • 1 October 2012 (v1.0.0)
    • First release.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Engineer
Turkey Turkey

Comments and Discussions

 
GeneralMy vote of 5 Pin
Ștefan-Mihai MOGA18-Nov-12 7:33
professionalȘtefan-Mihai MOGA18-Nov-12 7:33 
GeneralMy vote of 5 Pin
Manoj Kumar Choubey15-Nov-12 19:47
professionalManoj Kumar Choubey15-Nov-12 19:47 
GeneralGood article Pin
Mehdi Payervand14-Nov-12 18:36
Mehdi Payervand14-Nov-12 18:36 
GeneralMy vote of 5 Pin
Sarvesh Kushwaha10-Nov-12 18:10
Sarvesh Kushwaha10-Nov-12 18:10 
GeneralMy vote of 5 Pin
ibrahim ragab10-Nov-12 13:28
ibrahim ragab10-Nov-12 13:28 
GeneralMy vote of 5 Pin
Thomas Daniels9-Nov-12 6:07
mentorThomas Daniels9-Nov-12 6:07 
GeneralMy vote of 5 Pin
Mohammad A Rahman8-Nov-12 18:01
Mohammad A Rahman8-Nov-12 18:01 
Questionnice Pin
BillW338-Nov-12 11:10
professionalBillW338-Nov-12 11:10 
GeneralMy vote of 5 Pin
Hernán Hegykozi29-Oct-12 13:48
Hernán Hegykozi29-Oct-12 13:48 
GeneralMy vote of 5 Pin
hari1911325-Oct-12 18:34
hari1911325-Oct-12 18:34 
QuestionThanks Pin
AlirezaDehqani25-Oct-12 4:16
AlirezaDehqani25-Oct-12 4:16 
QuestionThanks for a useful tool Pin
Jim Meadors22-Oct-12 19:16
Jim Meadors22-Oct-12 19:16 
AnswerRe: Thanks for a useful tool Pin
Huseyin Atasoy23-Oct-12 1:15
Huseyin Atasoy23-Oct-12 1:15 
GeneralRe: Thanks for a useful tool Pin
Jim Meadors24-Oct-12 20:32
Jim Meadors24-Oct-12 20:32 
GeneralMy vote of 5 Pin
Code Master3822-Oct-12 6:00
Code Master3822-Oct-12 6:00 
GeneralMy vote of 5 Pin
imgen17-Oct-12 17:33
imgen17-Oct-12 17:33 
Suggestionvote of 5, one correction regarding threads Pin
Antonio Nakić Alfirević17-Oct-12 1:19
Antonio Nakić Alfirević17-Oct-12 1:19 
GeneralRe: vote of 5, one correction regarding threads Pin
Huseyin Atasoy17-Oct-12 2:40
Huseyin Atasoy17-Oct-12 2:40 
QuestionMy vote of 5 Pin
Ratish Philip17-Oct-12 0:23
Ratish Philip17-Oct-12 0:23 
GeneralMy vote of 5 Pin
Rajesh Pillai7-Oct-12 21:07
Rajesh Pillai7-Oct-12 21:07 
GeneralMy vote of 5 Pin
Аslam Iqbal6-Oct-12 19:46
professionalАslam Iqbal6-Oct-12 19:46 
GeneralRe: My vote of 5 Pin
Huseyin Atasoy7-Oct-12 7:39
Huseyin Atasoy7-Oct-12 7:39 
QuestionLooks very good, but why the use "different way" use of threading ? Pin
BillWoodruff5-Oct-12 14:20
professionalBillWoodruff5-Oct-12 14:20 
AnswerRe: Looks very good, but why the use "different way" use of threading ? Pin
Huseyin Atasoy6-Oct-12 4:35
Huseyin Atasoy6-Oct-12 4:35 
Thanks for the feedback.
My "different way" is only an alternative approach.
We have a WebClient and we are using it to download files. You know, DownloadFile() function blocks the thread it is called from. That is why we need a new thread.
On the other hand I used DocumentCompleted event. When this event is fired we must do the next operation.(Navigate to the login page > fill the form and submit > navigate to article list) All these functions are asynchronous, because we are calling them from DocumentCompleted event.
What my way alternative for?
In such situations "generally" we use events. I can fire an event instead of invoking an action when DocumentCompleted event is fired. But I think using Actions and an invoker is simpler than using events in c#. In vb.net events are easier and this approach looks like them.
Finally, I can't use English efficiently. So things that I can explain are limited. I am sorry about that.
Please examine the source code, I think you will understand it easly.
Thanks for the feedback again...
GeneralRe: Looks very good, but why the use "different way" use of threading ? Pin
BillWoodruff6-Oct-12 15:22
professionalBillWoodruff6-Oct-12 15:22 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.