CZ:Enhancing your editing with javascript extensions: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Stephen Ewen
(image)
m (Text replacement - "CZ:How to Edit the Citizendium" to "CZ:How to edit an article")
 
(32 intermediate revisions by 12 users not shown)
Line 1: Line 1:
[[Image:Javascript.jpg|thumb|400px|right|Java can greatly enhancing your Citizendium editing experience.]]
{{Image|Javascript.jpg|right|300px|Javascript can greatly enhance your Citizendium editing experience.}}


This page tells you about ways to enhance your Citizendium contributing experience by adding ''javascripts'' to your [[Special:Mypage/monobook.js]] page.<ref>If you have set a skin other than Citizendium's default monobook in your "my preferences", see [http://en.wikipedia.org/wiki/User:Cacycle/wikEd the wikEd author page] to learn how to adjust the directions that follow.</ref> Like the name implies, Special:Mypage/monobook.js is a page where you can add special extensions that work with the MediaWiki software upon which Citizendium runs.
This page tells you about ways to enhance your Citizendium contributing experience by adding [[JavaScript]]s to your [[Special:Mypage/Pinkwich5.js]] page.<ref>If you have set a skin other than Citizendium's default Pinkwich5 in your "my preferences", see [http://en.wikipedia.org/wiki/User:Cacycle/wikEd the wikEd author page] to learn how to adjust the directions that follow.</ref> Like the name implies, Special:Mypage/Pinkwich5.js is a special page where you can add javascript extensions that work with the MediaWiki software upon which Citizendium runs.


If any of that sounds a little too much like "Greek" to you, relax.  Enhancing your Citizendium experience with java extensions is a lot easier than you may think.  Just follow the easy directions below.
If any of that sounds a little too much like "Greek" to you, relax.  Enhancing your Citizendium experience with javascript extensions is a lot easier than you may think.  Just follow the easy directions below.


==wikEd==
==wikEd==
[[Image:WikEd Screenshot.jpg|thumb|400px|right|Screenshot of wikEd showing Citizendium's approved Biology article.]]
{{Image|WikEd screenshot.jpg|right|520px|Screenshot of wikEd showing Citizendium's approved Biology article.}}
 
===Purpose===
Have you ever wished that the Citizendium editing window were more like your word processor? Or that you could use your word processor to write a Citizendium article, paste it into the edit window, and then turn it into wiki markup with just a click? Thanks to wikEd, both can be so!
'''WikEd''' adds rich features to all Citizendium edit windows and pages.  When you open a Citizendium article to edit it, it will look and feel a lot like the word processor you may be used to.  Above the window, you will have many new buttons that create "wikicode" with just a press (pause your mouse for a few seconds over buttons for a message explaining what each does).  WikEd also adds a few very helpful features just below the edit page window, as well as on top of the page.  With wikEd you can:
 
WikEd adds rich features to all Citizendium edit windows and pages.  When you open a Citizendium article to edit it, it will look and feel a lot like the word processor you may be used to.  Above the window, you will have many new buttons that create "wikicode" with just a press.  Pause your mouse for a few seconds over buttons for a message explaining what each does.  WikEd also adds a few very helpful features just below the edit page window, as well as on top of the page.  With wikEd you can:


*Paste in formatted text and tables from your word processor and convert it to wiki markup
*Paste in formatted text and tables from your word processor and convert it to wiki markup
Line 22: Line 20:
*Much, much more!
*Much, much more!


You may have to try wikEd for a while to fully appreciate it.  You can remove it in seconds just as easily as you can add it, so don't worry that it might damage anything.  You can also turn it off and on with just the click of a new button it adds to the top right corner of all edit pages, next to the "log out" link. After you give it a solid go, you may find yourself wondering, ''How did I ever live without this before?''  
You may have to try wikEd for a while to fully appreciate it.  You can remove it in seconds just as easily as you can add it, so don't worry that it might damage anything.  You can also turn it off and on with just the click of a new button it adds to the top right corner of all edit pages, next to the "log out" link.   


If you want a much more in-depth description of wikEd, [http://en.wikipedia.org/wiki/User:Cacycle/wikEd visit its author's page].  While there, make sure you see [http://en.wikipedia.org/wiki/User:Cacycle/wikEd#Known_general_issues known general issues] for its few easy-to-live-with bugs.  WikEd is released to the public domain.  
If you want a much more in-depth description of wikEd, [http://en.wikipedia.org/wiki/User:Cacycle/wikEd visit its author's page].  While there, make sure you see [http://en.wikipedia.org/wiki/User:Cacycle/wikEd#Known_general_issues known general issues] for its few easy-to-live-with bugs.  WikEd is released to the public domain.  
Line 30: Line 28:
The directions just below explain how to both install and uninstall wikEd for use at Citizendium.
The directions just below explain how to both install and uninstall wikEd for use at Citizendium.


====Installation====
===How to install===
:1. Ensure that javascript is enabled in your Firefox or Mozilla-based browser.  It is turned on by default.
:2. Click 'Install' on http://en.wikipedia.org/wiki/User:Cacycle/wikEd
:: - or -
::a. [[Special:Mypage/Pinkwich5.js|Click here]] to open your Pinkwich5.js page.
::b. Click the "edit" tab at the top of the page.
::c. In the edit window that opens, copy and paste: '''<tt><nowiki>{{wikEd}}</nowiki></tt>'''
::d. Click the '''Save page''' button.
::e. Invoke a "hard refresh": In Internet Explorer press Ctrl+F5; in Mozilla Firefox press Shift+Ctrl+R (Shift+Cmd+R on Mac); in Opera press F5.


:1. Ensure that javascript is enabled in your Firefox or Mozilla-based browser.  It is be turned on by default.  
WikEd should now be installed. To test it, go to any page you may be interested in editing and click the "edit" tab at the top of the page.
:2. [[Special:Mypage/monobook.js|Click here]] to open your monobook.js page.
:3. Click the "edit" tab at the top of the page.
:4. In the edit window that opens, copy and paste the below text exactly as shown.


<pre><nowiki>
===Uninstall===
To uninstall, just revert your [[Special:Mypage/Pinkwich5.js|Pinkwich5.js]] page.


// installation of the wikEd editing page extension
==Navigation popups==
[[Image:Onslow_Beach_popup.jpg|thumb|right|520px]]
===Purpose===
'''Navigation popups''' allows you to view a preview of an article inside a popup box without leaving your current page. This allows you to view the introduction to any article simply by moving your mouse over the link to that article without the need to click forward and backwards between pages.  When you pause your mouse over a link, the popup will appear. After a few moments, the introduction from the linked article will be loaded into the popup box.


// install [[User:Cacycle/diff]] text diff code
The popups also add additional information and menu links that assist with editing and maintaining articles for both authors and editors. There is also an optional feature that can be enabled to give system administrators and constables some advanced tools.
document.write('<script type="text/javascript" src="'
+ 'http://en.wikipedia.org/w/index.php?title=User:Cacycle/diff.js'
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');


// install [[User:Pilaf/Live_Preview]] page preview tool
===How to install===
document.write('<script type="text/javascript" src="'
To use, you must be a logged in member of the site. The script doesn't work for people who aren't logged in. Once logged in, just click here to your own [[Special:Mypage/Pinkwich5.js|Pinkwich5.js]] file. Edit this page an add this single line of code:
+ 'http://en.wikipedia.org/w/index.php?title=User:Pilaf/livepreview.js'
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');


// install [[User:Mboverload/RegExTypoFix|RegExTypoFix]] common typo fixer
<nowiki>{{subst:navpop}}</nowiki>
document.write('<script type="text/javascript" src="'
+ 'http://en.wikipedia.org/w/index.php?title=User:Cacycle/RegExTypoFix.js'
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');


// install [[User:Cacycle/wikEd international]] translation here
Now Save the page.


// install [[User:Cacycle/wikEd]] editing page extension
Lastly, do a hard reload/refresh of your browser screen. (to load in the javascript to your browser's cache). This is done by:
document.write('<script type="text/javascript" src="'
*Internet Explorer - Ctrl+F5
+ 'http://en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd.js'
*Mozilla Firefox - Shift+Ctrl+R (Shift+Cmd+R on Mac)
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');
*Opera - F5


</nowiki></pre>
===Uninstall===
Go to your [[Special:Mypage/Pinkwich5.js|Pinkwich5.js]] file and delete the line of previously inserted then save and do the hard refresh of your browser again.


:5. Click the '''Save page''' button.
==refToolbar==
:6. Press CTRL + F5 at the same time to invoke a "hard refresh".
This is a JavaScript tool that adds an extra button to the editing toolbar for commonly used citation templates such as {{cite web}}, {{cite news}}, {{cite book}}, and {{cite journal}}. It also adds an attractive form in which to enter your data and some tools for error checking other ref links.


WikEd should now be installed. To test it, go to any page you may be interested in editing and click the "edit" tab at the top of the page.
===How to install===
Just click here to your own [[Special:Mypage/Pinkwich5.js|Pinkwich5.js]] file. Edit this page an add this single line of code:
 
<nowiki>importScript('User:Derek_Harkness/refToolbar.js');</nowiki>


To uninstall, just revert.
Now Save the page.


==Navigation popups==
Lastly, do a hard reload/refresh of your browser screen. (to load in the javascript to your browser's cache). This is done by:
'''Navigation popups''' is an extension that allows you to much more easily view article previews.  When you pause your mouse over the links in the "popup", it provides a few additional features.
*Internet Explorer - Ctrl+F5
*Mozilla Firefox - Shift+Ctrl+R (Shift+Cmd+R on Mac)
*Opera - F5


Although it would probably take only minutes, the javascript for Navigation popups is not yet modified for use on Citizendium. You can [http://en.wikipedia.org/wiki/Wikipedia:Tools/Navigation_popups visit its author's page] until such a time.
===Uninstall===
Go to your [[Special:Mypage/Pinkwich5.js|Pinkwich5.js]] file and delete the line of previously inserted then save and do the hard refresh of your browser again.


==Other extensions==
==Other extensions==
Line 81: Line 87:


==Notes==
==Notes==
<div> <references /></div>
{{reflist}}
 
==Also see==
*[[CZ:How to edit an article]]
 
{{Technical Help}}

Latest revision as of 04:38, 8 March 2024

Javascript can greatly enhance your Citizendium editing experience.

This page tells you about ways to enhance your Citizendium contributing experience by adding JavaScripts to your Special:Mypage/Pinkwich5.js page.[1] Like the name implies, Special:Mypage/Pinkwich5.js is a special page where you can add javascript extensions that work with the MediaWiki software upon which Citizendium runs.

If any of that sounds a little too much like "Greek" to you, relax. Enhancing your Citizendium experience with javascript extensions is a lot easier than you may think. Just follow the easy directions below.

wikEd

Screenshot of wikEd showing Citizendium's approved Biology article.

Purpose

WikEd adds rich features to all Citizendium edit windows and pages. When you open a Citizendium article to edit it, it will look and feel a lot like the word processor you may be used to. Above the window, you will have many new buttons that create "wikicode" with just a press (pause your mouse for a few seconds over buttons for a message explaining what each does). WikEd also adds a few very helpful features just below the edit page window, as well as on top of the page. With wikEd you can:

  • Paste in formatted text and tables from your word processor and convert it to wiki markup
  • See wiki markup syntaxes highlighted in assigned colors
  • Search and replace
  • See previews and changes
  • Edit in fullscreen mode
  • Fix common mistakes with just a click
  • Keep track of summary, search, and replace fields
  • Navigate quickly to headings
  • Much, much more!

You may have to try wikEd for a while to fully appreciate it. You can remove it in seconds just as easily as you can add it, so don't worry that it might damage anything. You can also turn it off and on with just the click of a new button it adds to the top right corner of all edit pages, next to the "log out" link.

If you want a much more in-depth description of wikEd, visit its author's page. While there, make sure you see known general issues for its few easy-to-live-with bugs. WikEd is released to the public domain.

As of March 2007, wikEd will only work if you use Firefox or another Mozilla-based browser. To get Firefox, which also adds a spell-checker to the Citizendium editing window, visit its download page.

The directions just below explain how to both install and uninstall wikEd for use at Citizendium.

How to install

1. Ensure that javascript is enabled in your Firefox or Mozilla-based browser. It is turned on by default.
2. Click 'Install' on http://en.wikipedia.org/wiki/User:Cacycle/wikEd
- or -
a. Click here to open your Pinkwich5.js page.
b. Click the "edit" tab at the top of the page.
c. In the edit window that opens, copy and paste: {{wikEd}}
d. Click the Save page button.
e. Invoke a "hard refresh": In Internet Explorer press Ctrl+F5; in Mozilla Firefox press Shift+Ctrl+R (Shift+Cmd+R on Mac); in Opera press F5.

WikEd should now be installed. To test it, go to any page you may be interested in editing and click the "edit" tab at the top of the page.

Uninstall

To uninstall, just revert your Pinkwich5.js page.

Navigation popups

Onslow Beach popup.jpg

Purpose

Navigation popups allows you to view a preview of an article inside a popup box without leaving your current page. This allows you to view the introduction to any article simply by moving your mouse over the link to that article without the need to click forward and backwards between pages. When you pause your mouse over a link, the popup will appear. After a few moments, the introduction from the linked article will be loaded into the popup box.

The popups also add additional information and menu links that assist with editing and maintaining articles for both authors and editors. There is also an optional feature that can be enabled to give system administrators and constables some advanced tools.

How to install

To use, you must be a logged in member of the site. The script doesn't work for people who aren't logged in. Once logged in, just click here to your own Pinkwich5.js file. Edit this page an add this single line of code:

{{subst:navpop}}

Now Save the page.

Lastly, do a hard reload/refresh of your browser screen. (to load in the javascript to your browser's cache). This is done by:

  • Internet Explorer - Ctrl+F5
  • Mozilla Firefox - Shift+Ctrl+R (Shift+Cmd+R on Mac)
  • Opera - F5

Uninstall

Go to your Pinkwich5.js file and delete the line of previously inserted then save and do the hard refresh of your browser again.

refToolbar

This is a JavaScript tool that adds an extra button to the editing toolbar for commonly used citation templates such as Error on call to Template:cite web: Parameters url and title must be specified., Template error: argument title is required. , {{{title}}}. , and "{{{title}}}". . It also adds an attractive form in which to enter your data and some tools for error checking other ref links.

How to install

Just click here to your own Pinkwich5.js file. Edit this page an add this single line of code:

importScript('User:Derek_Harkness/refToolbar.js');

Now Save the page.

Lastly, do a hard reload/refresh of your browser screen. (to load in the javascript to your browser's cache). This is done by:

  • Internet Explorer - Ctrl+F5
  • Mozilla Firefox - Shift+Ctrl+R (Shift+Cmd+R on Mac)
  • Opera - F5

Uninstall

Go to your Pinkwich5.js file and delete the line of previously inserted then save and do the hard refresh of your browser again.

Other extensions

The extensibility of the Wikmedia software upon which Citizendium runs is all but limitless. Add to and keep attuned to this page and the Citizendium-L mailing list.

Notes

  1. If you have set a skin other than Citizendium's default Pinkwich5 in your "my preferences", see the wikEd author page to learn how to adjust the directions that follow.

Also see


Citizendium Technical Help
How to edit an article | Searching | Start article with subpages
The Article Checklist | Subpage template

|width=10% align=center style="background:#F5F5F5"|  |}