Editor tour
Article conception in Mathete system
1. Any
registered user can create his own articles. This
user is called article author.
2.
Mathete
article should not be confused with publication. User chooses the
level of accessibility for the article himself. Initially,
the article is available only to the article author. The
following terms may be more appropriate: "worksheet",
"draft". If desired, the author can publish it in Mathete
catalog.
3.
With the
general approach to the articles containing different types of
information – text paragraphs, mathematical calculations, images,
graphs, it is convenient to divide it into paragraphs. This approach
is just used in Mathete. We use
different types of paragraphs (text, mathematics, graphics, and
images). Paragraphs
are the blocks that make up the article.
4.
Likewise,
each article can be considered as a set of calculations or even as a
program. From this point of view sequence of paragraphs is also
important. And, therefore, the
concept of "source code" is also applied to Mathete article
What is Article Editor?
Article Editor is the editor designed for fast, easy and intuitive creation of articles with rich mathematical capabilities. Main editable elements:
•
text with
various formatting: selection, headings, lists (bulleted or
numbered), and links;
•
mathematical equations with various elements – fractions,
exponentiation, roots, integrals, sums, etc.;
•
charts;
•
images;
•
computational structures;
•
fields for data input;
Editing Tools:
•
Add and edit
paragraphs in WYSIWYG mode (What you see is what you get);
•
View and edit article source code;
•
Preview of the article and calculation before its publication;
•
Set the access to the article: only for user, by direct link and for
all;
•
Managing publication of separate paragraphs;
•
Managing calculations of separate mathematical paragraphs.
Editor Interface
Let’s see editor interface in details.
Article editor has four tabs:
Editor – to edit article and its paragraphs in WYSIWYG mode (What you see is what you get);
Source code – to view and edit article source code;
Preview – article preview;
Settings – general article settings.
Editor tab
As mentioned above this tab is designed for editing the article in WYSIWYG mode. We see two areas: "viewing area" and "edit panel"
In viewing area all the paragraphs are displayed, that are currently present in the article. For convenience, the paragraphs are separated by thin lines, while to the left you can see serial numbers.
There are icons of available manipulations to the right of each section.
General icons. Icons for the paragraphs of all types:
-
Edit. After clicking on
this icon the paragraph will be available for editing in editing
panel
- Publish. After
clicking it
changes to
.
It means that paragraph being visible in the
editor will be hidden during viewing of the article. Second click
opens the “eye” and the paragraph will be published.
-
Delete. Clicking on this icon will delete the paragraph from the
article.
Specific icons for mathematical paragraphs:
-
Calculation. Calculates current mathematical paragraph and shows
result
-
Availability to calculate. After click changes to
.
It means that the paragraph is not used in calculations. Second click
changes icon and the paragraph can be calculated.
Edit panel consists of tabs with the names of paragraph types, at each you can directly edit paragraph of this type. As well as the icons to manage of the entire article:
-
Undo last action.
-
Return
the last undone action.
-
Calculation
of the entire article.
-
Reset the
results of all calculations.
-
Save article. During next opening of the article
it will have content at the time of last save.
Adding and editing article paragraphs.
Paragraphs are clearly separated by type in Mathete. You can add or edit the paragraph in edit panel in the appropriate tab.
There are three elements in paragraph editing area of any type:
1. Input field of paragraph number.
2. Input area of paragraph content.
3. "Enter" button.
The following procedure is used when adding the paragraph:
1. The type of paragraph is determined. The appropriate tab opens;
2. By default, in input field of paragraph number, the number of expected last paragraph of the article is located;
3. If you want to insert a paragraph between existing ones, the number is set as a fractional number between the numbers of those paragraphs, where you want to insert the paragraph;
4. If you want to replace the existing paragraph, the number is put equal to the number of the section being replaced;
5. Next, you enter the paragraph content. Details of paragraph input of various types are given below;
6. Click on "Enter", and paragraph appears in the viewing area.
Next we consider work with each paragraph type in details
Text paragraph
To format the text "markdown” formatting is used. You can define headings, highlight text parts in italics, bold, and create lists, insert links. The most prominent is the feature inherent to Mathete – you can easily insert a variety of mathematical equations.
Plain text. Paragraphs
Simply type the text, as in any other text editor. To separate paragraphs use an empty string
Creating headings
To create a heading enter "#" symbol in the beginning of the line. Heading level is determined by the number of "#" symbols.
Example input:
Result:
Text selection
To select text in italics or bold "*" symbol is used. To highlight text in italics it is segregated with single "*" symbol, to highlight in bold – with two "*" symbols.
Example:
Result:
Equation insertion in text paragraph
To insert equation you can use «<<» and «>>» characters. Generally equation insertion is like: << equation >>
Text paragraph with the equation will look like:
Lists
Example of numbered list input:
1. first item text
1. second item text
1. third item text
Example of marked list
* first item text
* second item text
Mathematical paragraph
At first glance it might seem that there is no difference from the text paragraph. Let’s point out features of the mathematical paragraph:
1. Mathematical paragraph consists of a single line.
2. One paragraph may contain several sub-paragraphs, separated by ";" symbol.
3. Each mathematical paragraph can be calculated. This is not just an equation, but the command to Mathete for calculating.
4. The result of calculation is displayed immediately under the condition and is considered the part of the paragraph.
Error processing
In the event that input rules are not observed, if the system can not clearly understand the command, then the system displays an error message after input:
Input of numbers
Numbers are entered as usual. To separate integer and decimals "." symbol is used.
Resulting paragraph:
Addition and subtraction
To add numbers mathematical sign «plus» («+») is used, to subtract numbers mathematical sign «minus» («-») is used.
Resulting paragraph:
Multiplication
«*» symbol is used for multiplication.
Resulting paragraph:
Division
«/» (slash) symbol is used for division.
Resulting paragraph:
Exponentiation
For exponentiation between the base and the exponent «^» symbol is input or two «*» symbols in succession.
Resulting paragraph:
Rooting
"\" symbol is used for rooting. For simple root just type "\" before radicand. For rooting with random power, you type power followed by "\", and then radicand
Paragraph:
Absolute value
To get absolute value of the number the expression is segregated with straight lines «|».
Paragraph:
Factorial
To designate factorial in the end of mathematical expression put pling («!»).
Paragraph:
Use of symbols. Names. Assignment
When using the symbols you should follow the following rules:
• Any combination of letters and numbers can be used to indicate the names;
• The letter should be first when assigning a name;
• To assign a name it is not necessarily to use the Latin alphabet, you can use letters of any other language;
• To add a subscript, you should use "_" symbol;
• To type Greek letters in the names and subscripts use their names in English;
• To assign a value to the name, you should use "equal" symbol («=»). Nane value may be placed for calculations in subsequent paragraphs and subparagraphs. You can assign another value for the name;
• There is a possibility of multiple naming.
Names:
Naming:
Multiple naming:
Resulting paragraphs:
Variables
You can add fields to input the names in the article. This allows readers to assign their values to the names and perform calculation of tasks, equations with their initial data.
To add input fields use «input» function, which in general can be represented as:
a = input (3) or a = input (4,5,6)
To assign a value to the name by default, indicate a single value in brackets. To select a value from the list indicate several values.
Resulting paragraph:
Elementary functions
You can use logarithms, trigonometric functions, inverse trigonometric functions.
Resulting paragraph:
Arrays or vectors
To input an array or vector use square brackets (”[“ “]”). To separate the elements in the array a comma («,») is used.
Array element can be accessed by index. To do this, use the following syntax:
Array_Name [index]
The numbering of elements starts from zero. Any expression can be array element.
If the array is an arithmetic progression, it is convenient to use the following syntax:
Array_Name [1st array_element, 2nd array_element .. last_array_element]
If progression step is one, then the second element of the array can be omitted:
Array_Name [1st array_element .. last_array_element]
You can perform arithmetic operations with arrays and apply functions to them. The result of array calculation is the array of results.
Array:
Arithmetic sequence:
Actions and functions:
Arrays can look like this:
Eigenfunctions
You can define your own eigenfunctions do use them in future.
Paragraph:
Infinity
All
numbers over
are considered infinity. Infinity or NaN can be the result of action
with infinity.
To indicate infinity you should sequentially type two Latin letters «o».
Calculation results are given below:
Sum. Product
To denote the sum and product built-in functions «sum» and «prod» are used, respectively. Functions take three arguments. The first argument represents an expression for summation (product), the second and third arguments – the limits. Limits are optional.
Mathematical expressions will look like:
Derivatives
To input derivatives use built-in function «diff».
Mathematical expressions will look like:
To input integrals built-in function «integral» is used.
Mathematical expressions will look like:
Ratios. Boolean types
To compare expressions use the following operators:
«==» - equal;
«!=» - not equal;
«>» - more;
«<» - less;
«>=» - more or equal;
«<=» - less or equal.
Expression comparison result are Boolean type values «true» or «false». It is not recommended to use comparisons in symbolic calculations.
Mathematical expressions will look like:
Conditions
To input the conditions the following functions are used:
«if» - returns value depending on meeting the condition:
if(condition, value_for_meeting_the_condition, value_otherwise);
«switch» - returns value when the condition is met:
switch([condition 1, value_for_meeting_the_condition 1], [condition 2, value_for_meeting_the_condition 2], …, [condition n, value_for_meeting_the_condition n];
As you can see from syntax «switch» function can have any number of arrays.
Condition calculation result is given below:
Random numbers
To return random number from 0 to n «random (n)» function is used.
The function can look like:
Symbolic calculations
You can group symbolic summands and multipliers.
Grouping result is given below:
Chart paragraph
You can draw up to three plots on the same graph;
Data is entered in two arrays: X-coordinate and Y-coordinate;
If you enter an array of coordinates, you can use the names from the article or from previous mathematical paragraph.
You can choose color and type of chart;
You can add a "legend";
Width and height of the chart is specified in pixels;
Adding images
Press View button. Standard window opens.
Select image file;
To add image to the article in Image tab press Enter button.
Edit article source code
The advantage of editing the article in "Source code" mode is quick input of several paragraphs. Text paragraphs are separated by blank lines; mathematical paragraphs are highlighted as follows:
{{{
mat.Paragraph1
....
mat.ParagraphN
}}}
To remove paragraph from publication, put ';;' at the beginning of the line
Content of Source code tab is uniquely relevant to the content that is in Editor tab. Any changes made in the source code can be seen when switching to the editor tab. And vice versa.
Article Preview
Preview is necessary to conduct additional validation of article before publication.
To preview the article, click the Preview tab:
Article settings
All settings should be intuitive. Let’s consider in detail only the publication of the article for all:
1. In Access field, select access mode "publication";
2. In Category field, select the category of published article from the list;
3. In Tags field, enter the key words for search of the article;
4. In order for readers to see the source code of the article, activate Show source code mode;
5. In order for readers to add comments to the article, activate Comments mode;
6.
Click Save.
Now
you
can try demo version of Article Editor without registration. Article
settings and ability to save are disabled in demo version. Go to demo
