WikEmacs - User contributions [en]

Mediawiki.el

2012-09-19T19:39:49Z

Daniel K. Schneider: /* Setup */

{{Package
|name=mediawiki.el
|description=Mediawiki interface and markup mode
|author= Jerry et al
|maintainer=Mark A. Hershberger
|source=https://code.launchpad.net/~hexmode/mediawiki-el/trunk
|in_emacs=no
|Development status=active
|website=https://code.launchpad.net/~hexmode/mediawiki-el
}}

'''Mediawiki.el''' is a package to help add content to any mediawiki
site including ''WikEmacs''. It comes with a [[Major Mode]] to support editing
Mediawiki markup.

==Setup==

Install '''mediawiki.el''' from [[el-get]] or [[ELPA]].

If you are using emacs-24, you could do the following: Edit your .emacs file like this:
<syntaxhighlight lang="lisp">
(require 'package)
(package-initialize)
;; Not sure which one should come first, but you certainly one of these.
;; As of sept. 2012, this package is not in ELPA
(add-to-list 'package-archives '("marmalade" . "http://marmalade-repo.org/packages/") t)
(add-to-list 'package-archives '("melpa" . "http://melpa.milkbox.net/packages/") t)
</syntaxhighlight>

Then, either use the menu ''Options->Manage Emacs Packages'' or type ''M-X package-list-packages''
* search ''mediawiki'' and click on it
... almost done.

=== Site requirements ===

The MediaWiki site that you wish to edit must have its API enabled:

<pre>
$wgEnableAPI=true;
</pre>

==Customization==

; {{Command|load-library RET mediawiki RET}}
: Load the library

; {{CustomizeVariable|mediawiki-site-alist}}
: Configure as follows and save your settings
:: '''Site Name''': WikEmacs
:: '''URL''': ''http://wikemacs.org/w/''
:: '''Username''': ''InCognito''
:: '''Password''': ''s!cr!t''
:: '''First Page''': ''Main Page''
: You can provide "Username" and "Password" in your [[.authinfo]] file. home directory.

Alternatively you can add this snippet of Emacs Lisp code to your
[[.emacs]]:

<syntaxhighlight lang="lisp">
(require 'mediawiki)

(setq mediawiki-site-alist '(("Wikipedia" "http://en.wikipedia.org/w/ "" "" "Main Page") ; put your user name and password
("WikEmacs" "http://wikemacs.org/w/" "" "" "Main Page")))

;; Emacs users care more for WikEmacs than Wikipedia :-).
;; In any case, do not forget the slash at the end of the URL.
(setq mediawiki-site-default "WikEmacs")
</syntaxhighlight>

You can naturally add more MediaWiki sites to the
'''mediawiki-site-alist''' variable.

==Usage==
; {{Command|mediawiki-site}}
: Choose a site (say "WikEmacs") for the current session.

; {{CommandKeys|C-c C-o|mediawiki-open}}
: Open a page. To edit the main page, type "Main Page". Make your edits.

; {{CommandKeys|C-x C-s|mediawiki-save}}
: Submit your modifications.

; {{CommandKeys|C-c|mediawiki-save-and-bury}}
: Submit modifications and bury the buffer.

== Helpful Keybindings==

; {{CommandKeys|C-return|mediawiki-open-page-at-point}}
: Follow or browse to a WikiLink.

; {{CommandKeys|M-g|mediawiki-reload}}
: Reload a page

==Customizations==
=== Word Wrap ===

Mediawiki sites are generally [[Emacs_Terminology#Fill |unfilled]]: do not add hard line breaks within a paragraph. There are various ways to wrap lines [[Emacs_Terminology#Screen Lines |visually]] while you edit. For example in Emacs 24 you may want to enable [[Visual Line]] mode with a [[mode hook]]:

<syntaxhighlight lang="lisp">
(setq mediawiki-mode-hook (lambda ()
(visual-line-mode 1)))
</syntaxhighlight>

=== Edit or Create a page in a web browser ===

Right now '''Mediawiki.el''' fails silently whenever the site asks for number challenge
(spam protection). The following snippet allows you to edit/create a
page in a web browser

<syntaxhighlight lang="lisp">
(defun yyr-mediawiki-browser-edit/create-page (page &optional site)
"Edit a page in browser, asks for page name (sitename also if needed)"
(interactive "sPage name (words): ")
(let* ((site (mediawiki-prompt-for-site))
(url (mediawiki-site-extract site 1))
(index "index.php?title=")
(et "&action=edit"))
(funcall 'browse-url
(message "%s%s%s%s"
url index (mediawiki-translate-pagename page) et))))
</syntaxhighlight>

Call {{Function| yyr-mediawiki-browser-edit/create-page}}

=== key binding to open current editing file in web browser? ===

bind {{Function|mediawiki-browse}} to some key chord. The following
uses {{Keys|C-c o}}

<syntaxhighlight lang="lisp">

(define-key mediawiki-mode-map (kbd "C-c o") 'mediawiki-browse)

</syntaxhighlight>

==External Links==
*[http://www.emacswiki.org/emacs/MediaWikiMode EmacsWiki:MediaWikiMode]
*[https://launchpad.net/mediawiki-el Project Page]

[[Category:Third Party Package]]
[[Category:Markup languages]]

Mediawiki.el

2012-09-19T19:17:21Z

Daniel K. Schneider: /* Customization */

{{Package
|name=mediawiki.el
|description=Mediawiki interface and markup mode
|author= Jerry et al
|maintainer=Mark A. Hershberger
|source=https://code.launchpad.net/~hexmode/mediawiki-el/trunk
|in_emacs=no
|Development status=active
|website=https://code.launchpad.net/~hexmode/mediawiki-el
}}

'''Mediawiki.el''' is a package to help add content to any mediawiki
site including ''WikEmacs''. It comes with a [[Major Mode]] to support editing
Mediawiki markup.

==Setup==

Install '''mediawiki.el''' from [[el-get]] or [[ELPA]].

=== Site requirements ===

The MediaWiki site that you wish to edit must have its API enabled:

<pre>
$wgEnableAPI=true;
</pre>

==Customization==

; {{Command|load-library RET mediawiki RET}}
: Load the library

; {{CustomizeVariable|mediawiki-site-alist}}
: Configure as follows and save your settings
:: '''Site Name''': WikEmacs
:: '''URL''': ''http://wikemacs.org/w/''
:: '''Username''': ''InCognito''
:: '''Password''': ''s!cr!t''
:: '''First Page''': ''Main Page''
: You can provide "Username" and "Password" in your [[.authinfo]] file. home directory.

Alternatively you can add this snippet of Emacs Lisp code to your
[[.emacs]]:

<syntaxhighlight lang="lisp">
(require 'mediawiki)

(setq mediawiki-site-alist '(("Wikipedia" "http://en.wikipedia.org/w/ "" "" "Main Page") ; put your user name and password
("WikEmacs" "http://wikemacs.org/w/" "" "" "Main Page")))

;; Emacs users care more for WikEmacs than Wikipedia :-).
;; In any case, do not forget the slash at the end of the URL.
(setq mediawiki-site-default "WikEmacs")
</syntaxhighlight>

You can naturally add more MediaWiki sites to the
'''mediawiki-site-alist''' variable.

==Usage==
; {{Command|mediawiki-site}}
: Choose a site (say "WikEmacs") for the current session.

; {{CommandKeys|C-c C-o|mediawiki-open}}
: Open a page. To edit the main page, type "Main Page". Make your edits.

; {{CommandKeys|C-x C-s|mediawiki-save}}
: Submit your modifications.

; {{CommandKeys|C-c|mediawiki-save-and-bury}}
: Submit modifications and bury the buffer.

== Helpful Keybindings==

; {{CommandKeys|C-return|mediawiki-open-page-at-point}}
: Follow or browse to a WikiLink.

; {{CommandKeys|M-g|mediawiki-reload}}
: Reload a page

==Customizations==
=== Word Wrap ===

Mediawiki sites are generally [[Emacs_Terminology#Fill |unfilled]]: do not add hard line breaks within a paragraph. There are various ways to wrap lines [[Emacs_Terminology#Screen Lines |visually]] while you edit. For example in Emacs 24 you may want to enable [[Visual Line]] mode with a [[mode hook]]:

<syntaxhighlight lang="lisp">
(setq mediawiki-mode-hook (lambda ()
(visual-line-mode 1)))
</syntaxhighlight>

=== Edit or Create a page in a web browser ===

Right now '''Mediawiki.el''' fails silently whenever the site asks for number challenge
(spam protection). The following snippet allows you to edit/create a
page in a web browser

<syntaxhighlight lang="lisp">
(defun yyr-mediawiki-browser-edit/create-page (page &optional site)
"Edit a page in browser, asks for page name (sitename also if needed)"
(interactive "sPage name (words): ")
(let* ((site (mediawiki-prompt-for-site))
(url (mediawiki-site-extract site 1))
(index "index.php?title=")
(et "&action=edit"))
(funcall 'browse-url
(message "%s%s%s%s"
url index (mediawiki-translate-pagename page) et))))
</syntaxhighlight>

Call {{Function| yyr-mediawiki-browser-edit/create-page}}

=== key binding to open current editing file in web browser? ===

bind {{Function|mediawiki-browse}} to some key chord. The following
uses {{Keys|C-c o}}

<syntaxhighlight lang="lisp">

(define-key mediawiki-mode-map (kbd "C-c o") 'mediawiki-browse)

</syntaxhighlight>

==External Links==
*[http://www.emacswiki.org/emacs/MediaWikiMode EmacsWiki:MediaWikiMode]
*[https://launchpad.net/mediawiki-el Project Page]

[[Category:Third Party Package]]
[[Category:Markup languages]]

Mediawiki.el

2012-09-19T19:17:02Z

Daniel K. Schneider: /* Customization */

{{Package
|name=mediawiki.el
|description=Mediawiki interface and markup mode
|author= Jerry et al
|maintainer=Mark A. Hershberger
|source=https://code.launchpad.net/~hexmode/mediawiki-el/trunk
|in_emacs=no
|Development status=active
|website=https://code.launchpad.net/~hexmode/mediawiki-el
}}

'''Mediawiki.el''' is a package to help add content to any mediawiki
site including ''WikEmacs''. It comes with a [[Major Mode]] to support editing
Mediawiki markup.

==Setup==

Install '''mediawiki.el''' from [[el-get]] or [[ELPA]].

=== Site requirements ===

The MediaWiki site that you wish to edit must have its API enabled:

<pre>
$wgEnableAPI=true;
</pre>

==Customization==

; {{Command|load-library RET mediawiki RET}}
: Load the library

; {{CustomizeVariable|mediawiki-site-alist}}
: Configure as follows and save your settings
:: '''Site Name''': WikEmacs
:: '''URL''': ''http://wikemacs.org/w/''
:: '''Username''': ''InCognito''
:: '''Password''': ''s!cr!t''
:: '''First Page''': ''Main Page''
: You can provide "Username" and "Password" in your [[.authinfo]] file. home directory.

Alternatively you can add this snippet of Emacs Lisp code to your
[[.emacs]]:

<syntaxhighlight lang="lisp">
(require 'mediawiki)

(setq mediawiki-site-alist '(("Wikipedia" "http://en.wikipedia.org/w/ "" "" "Main Page") ; put your user name and password
("WikEmacs" "http://wikemacs.org/w/" "" "" "Main Page")))

;; Emacs users care more for WikEmacs than Wikipedia :-). In any case, do not forget the slash at the end of the URL.
(setq mediawiki-site-default "WikEmacs")
</syntaxhighlight>

You can naturally add more MediaWiki sites to the
'''mediawiki-site-alist''' variable.

==Usage==
; {{Command|mediawiki-site}}
: Choose a site (say "WikEmacs") for the current session.

; {{CommandKeys|C-c C-o|mediawiki-open}}
: Open a page. To edit the main page, type "Main Page". Make your edits.

; {{CommandKeys|C-x C-s|mediawiki-save}}
: Submit your modifications.

; {{CommandKeys|C-c|mediawiki-save-and-bury}}
: Submit modifications and bury the buffer.

== Helpful Keybindings==

; {{CommandKeys|C-return|mediawiki-open-page-at-point}}
: Follow or browse to a WikiLink.

; {{CommandKeys|M-g|mediawiki-reload}}
: Reload a page

==Customizations==
=== Word Wrap ===

Mediawiki sites are generally [[Emacs_Terminology#Fill |unfilled]]: do not add hard line breaks within a paragraph. There are various ways to wrap lines [[Emacs_Terminology#Screen Lines |visually]] while you edit. For example in Emacs 24 you may want to enable [[Visual Line]] mode with a [[mode hook]]:

<syntaxhighlight lang="lisp">
(setq mediawiki-mode-hook (lambda ()
(visual-line-mode 1)))
</syntaxhighlight>

=== Edit or Create a page in a web browser ===

Right now '''Mediawiki.el''' fails silently whenever the site asks for number challenge
(spam protection). The following snippet allows you to edit/create a
page in a web browser

<syntaxhighlight lang="lisp">
(defun yyr-mediawiki-browser-edit/create-page (page &optional site)
"Edit a page in browser, asks for page name (sitename also if needed)"
(interactive "sPage name (words): ")
(let* ((site (mediawiki-prompt-for-site))
(url (mediawiki-site-extract site 1))
(index "index.php?title=")
(et "&action=edit"))
(funcall 'browse-url
(message "%s%s%s%s"
url index (mediawiki-translate-pagename page) et))))
</syntaxhighlight>

Call {{Function| yyr-mediawiki-browser-edit/create-page}}

=== key binding to open current editing file in web browser? ===

bind {{Function|mediawiki-browse}} to some key chord. The following
uses {{Keys|C-c o}}

<syntaxhighlight lang="lisp">

(define-key mediawiki-mode-map (kbd "C-c o") 'mediawiki-browse)

</syntaxhighlight>

==External Links==
*[http://www.emacswiki.org/emacs/MediaWikiMode EmacsWiki:MediaWikiMode]
*[https://launchpad.net/mediawiki-el Project Page]

[[Category:Third Party Package]]
[[Category:Markup languages]]

Talk:Mediawiki.el

2012-09-19T18:55:26Z

Daniel K. Schneider: /* mediawiki.el */

Version 2.2.2 works fine on GNU Emacs 24.0.94.1 (i386-mingw-nt5.1.2600) when there is no challenge (e.g. arithmetic problem). But when external links are added, so there is a challenge, mediawiki doesn't alert the user or show the arithmetic problem. The only evidence of failure is that the page is never updated.

== mediawiki.el ==

It doesn't appear in the package list (ELPA) on emacs-24 (unless I got something wrong)
M-x package-list-packages
Probably on has to add other package repositories. I did the following in my .emacs:

(require 'package)
(package-initialize)
(add-to-list 'package-archives '("marmalade" . "http://marmalade-repo.org/packages/") t)
(add-to-list 'package-archives '("melpa" . "http://melpa.milkbox.net/packages/") t)

- [[User:Daniel K. Schneider|Daniel K. Schneider]] 21:40, 19 September 2012 (EEST)

==Filling==
It wouldn't hurt anything if you filled paragraphs, would it? Mediawiki ignores single line breaks.

Talk:Mediawiki.el

2012-09-19T18:40:40Z

Daniel K. Schneider:

Version 2.2.2 works fine on GNU Emacs 24.0.94.1 (i386-mingw-nt5.1.2600) when there is no challenge (e.g. arithmetic problem). But when external links are added, so there is a challenge, mediawiki doesn't alert the user or show the arithmetic problem. The only evidence of failure is that the page is never updated.

== mediawiki.el ==

It doesn't appear in the package list (ELPA) on emacs-24 (unless I got something wrong)
M-x package-list-packages
Probably on has to add other package repositories ... ?
- [[User:Daniel K. Schneider|Daniel K. Schneider]] 21:40, 19 September 2012 (EEST)

==Filling==
It wouldn't hurt anything if you filled paragraphs, would it? Mediawiki ignores single line breaks.