Link at 22:12, 25 February 2015

2015-02-25T22:12:53Z

← Older revision		Revision as of 15:12, 25 February 2015
Line 6:		Line 6:
	* Apache web sever or compatible (hosted web version only)		* Apache web sever or compatible (hosted web version only)
	* Modern graphical web browser (web client only)		* Modern graphical web browser (web client only)
			* Qt 4 and PySide 1.2.x (qautomome only)

	=Obtaining and installing AUTOMOME=		=Obtaining and installing AUTOMOME=
Line 17:		Line 18:

	=Using AUTOMOME=		=Using AUTOMOME=
	There are several ways to use AUTOMOME: as of version 3.x, it can be used as a text-only command-line version (<code>automome.py</code>), on the web using a fancy AJAX interface that gives nice formatting (<code>automome.html</code>, and the canonical version at http://automome.penguindevelopment.org/), or as a text-only web version (<code>automome-web.py</code>).		There are several ways to use AUTOMOME: as of version 4.0, it can be used as a text-only command-line version (<code>automome.py</code>), on the web using a fancy AJAX interface that gives nice formatting (<code>automome.html</code>, and the canonical version at http://automome.penguindevelopment.org/), as a text-only web version (<code>automome-web.py</code>), or using the graphical '''qautomome''' (<code>qautomome.py</code>).

	==Using the command-line version==		==Using the command-line version==
Line 62:		Line 63:

	As an example, http://automome.penguindevelopment.org/automome-web.py?n=10&c=om produces 10 memes from the "Molpish other" and "Meta-memes" categories.		As an example, http://automome.penguindevelopment.org/automome-web.py?n=10&c=om produces 10 memes from the "Molpish other" and "Meta-memes" categories.

			=Using qautomome=
			qautomome is essentially a stand-alone version of the web client; most of the web client's feature descriptions transfer directly to qautomome and therefore aren't listed separately in this section. One notable capability of qautomome is the export function: qautomome can export the full history of memes to a file (or it can generate a set amount of new memes to export); the currently supported formats are [[w:Comma-separated values\|CSV]] (which has plaintext, BBCode and (X)HTML fields) and [[w:fortune (Unix)\|fortune]]. You can find this feature in the Copy/export tab.

			In qautomome, there is no separate back-button; you can instead right-click Cuegan to view the previous meme. Keyboard-based operation is also possible; use the space bar, enter key or right arrow key for the next meme and backspace or the left arrow key for the previous one. Holding shift inverts the function.

	==Bugs and feedback==		==Bugs and feedback==

Link: Created page with "'''AUTOMOME''' is a random internet meme generator based on snowclone templates. It is a black-box reimplementation and extension of [http:..."

2015-02-16T21:01:47Z

Created page with "'''AUTOMOME''' is a random internet meme generator based on snowclone templates. It is a black-box reimplementation and extension of [http:..."

New page

'''AUTOMOME''' is a random [[w:Internet meme|internet meme]] generator based on [[w:Snowclone|snowclone]] templates. It is a black-box reimplementation and extension of [http://automeme.net/ AUTOMEME] (now defunct), based on the English dialect known as ''OTTish'', spoken in the [http://forums.xkcd.com/viewtopic.php?f=7&t=101043 xkcd forums thread of the Time comic], better known as the ''One True Thread'' or ''OTC''. The canonical web version is available at http://automome.penguindevelopment.org/.

=Dependencies=
* Python 3, tested versions 3.2.3 and 3.4.1
* Unicode-compatible system
* Apache web sever or compatible (hosted web version only)
* Modern graphical web browser (web client only)

=Obtaining and installing AUTOMOME=
AUTOMOME can be obtained from http://proj.penguindevelopment.org/automome/. [http://proj.penguindevelopment.org/automome/automome-latest.tar.xz Direct link to the latest version.]

AUTOMOME is designed to run from its own directory; <code>cd</code>ing to the directory and calling <code>automome.py</code> directly should work. Likewise, the web version should work out of the box if the AUTOMOME directory is in a location served by Apache.

If a setup is desired where the dictionary files (<code>*.dict.txt</code>) are placed in a different directory from the script files, the <code>AUTOMOME_PATH</code> environment variable may be set to the path to the dictionary files. <code>automome-web.py</code> may be placed in a different directory from <code>automome.py</code>, so long as <code>automome.py</code> is in the module search path; see [https://docs.python.org/3/tutorial/modules.html#the-module-search-path].

The client-side web interface <code>automome.html</code> by default attempts to get its data from <code>automome-web.py</code> at the same base URL as <code>automome.html</code>: e.g. if you host a web version of AUTOMOME at http://example.com/molpy/grapevine/automome.html, it will try to fetch data from http://example.com/molpy/grapevine/automome-web.py. Likewise, it will try to locate <code>cuegan.svg</code> in the same directory.

=Using AUTOMOME=
There are several ways to use AUTOMOME: as of version 3.x, it can be used as a text-only command-line version (<code>automome.py</code>), on the web using a fancy AJAX interface that gives nice formatting (<code>automome.html</code>, and the canonical version at http://automome.penguindevelopment.org/), or as a text-only web version (<code>automome-web.py</code>).

==Using the command-line version==
The plaintext command-line version can be used on any system with Python 3.x, and is perhaps the simplest way to use AUTOMOME. At present, it supports only two significant options: picking the categories and the number of memes displayed. <code>automome.py --help</code> should provide an adequate explanation:<pre>$ automome.py --help
Usage: automome.py [option] [num]
[option] may be one of the following:
-h, --help show this message and exit
-V, --version show version and exit
-c [cats], --categories=[cats] generate memes from the categories [cats]
(see below); the default is aom

[cats] may be any combination of the following letters:
a molpish memes from the original AUTOMEME (possibly OTTified)
o molpish other memes, i.e. non-AUTOMEME memes
m molpish meta-memes, i.e. memes originating in the OTT
A unmolpish AUTOMEME memes
O unmolpish other memes
t OTToMeme memes (xkcd memes by azule)

[num] is the number of memes to generate; if it is missing or invalid, it is
assumed to be 1.</pre>

As an example, the following code produces 10 memes from the "Molpish other" and "Meta-memes" categories:<pre>
automome.py -c om 10</pre>

==Using the web GUI==
The [http://automome.penguindevelopment.org/ web GUI] offers more advanced features, including formatted text and the ability to filter memes. A quick run-through of features:
===Main layout===
From the main layout, clicking the image of Cuegan produces a single meme. There is not much more to be said.

===Meme categories===
Clicking the ''Meme categories'' link allows you to change the categories of memes that will be displayed; the categories are the same as those used in the text-only version.

===Filter settings===
The ''Filter settings'' tab is slightly more complicated. First and foremost is the ''Filter expression'' box. This allows you to enter any [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions JavaScript regular expression], and only memes matching that expression will be displayed. Keep in mind that the regular expression is case sensitive; almost all words are uppercase. The regular expression is applied to the text-only version of the meme, so italicised words will be surrounded by underscores, and so on. If you wish to match all memes, leave the box blank or enter <code>.*</code>.

The ''Lock meme'' checkbox allows you to lock the template of the current meme: if it is active, clicking the Cuegan image will only produce memes using the same template as the currently shown meme.

===Copyable formats===
The ''Copyable formats'' tab provides three easy-to-copy output styles: plaintext (the same as <code>automome.py</code> itself would produce), BBCode (used on most forums) and (X)HTML, which can be used on your own websites.

==Using the text-only web version==
The text-only web version is a lightweight wrapper around the command-line version. In fact, if it is at all possible, you should use the command-line version directly. Nevertheless, if you still wish to use the text-only web version, simply point a browser at automome-web.py, either at your site or [http://automome.penguindevelopment.org/automome-web.py the canonical version]. Categories can be passed using the <code>c=</code> GET-parameter, and the number of memes can be passed using the <code>n=</code> GET-parameter. The categories are the same as the ones used in the text-only version, and the number of memes is limited to at most 100 at a time.

As an example, http://automome.penguindevelopment.org/automome-web.py?n=10&c=om produces 10 memes from the "Molpish other" and "Meta-memes" categories.

==Bugs and feedback==
{{bugs and feedback}}

[[Category:Software]]

AUTOMOME - Revision history

Link at 22:12, 25 February 2015

Link: Created page with "'''AUTOMOME''' is a random internet meme generator based on snowclone templates. It is a black-box reimplementation and extension of [http:..."