Difference between revisions of "FAQInstructors"
I.konyukhov (talk | contribs) |
I.konyukhov (talk | contribs) |
||
(31 intermediate revisions by the same user not shown) | |||
Line 7: | Line 7: | ||
=== Structure of syllabi === |
=== Structure of syllabi === |
||
− | + | ''' Core courses ''' |
|
+ | The lists of the core courses are placed here: |
||
+ | * [https://eduwiki.innopolis.university/index.php/List_of_core_courses Core courses] |
||
⚫ | |||
+ | |||
⚫ | |||
+ | |||
+ | The lists of the elective courses are placed here: |
||
+ | |||
+ | * [https://eduwiki.innopolis.university/index.php/List_of_Electives Electives] |
||
=== Structure of Teaching Regulation Document === |
=== Structure of Teaching Regulation Document === |
||
+ | |||
+ | Overall teaching regulation can be found here: |
||
+ | |||
+ | *[https://eduwiki.innopolis.university/index.php/OverallRegulations Overall teaching regulations] |
||
=== Individual instructors' pages === |
=== Individual instructors' pages === |
||
+ | |||
+ | By the following link you can find your personal instructor's page, edit it or create, if necessary. It's highly recommended to preserve common structure of the page during editing. |
||
+ | |||
+ | *[https://eduwiki.innopolis.university/index.php/Professors The list of instructors] |
||
= Content editing = |
= Content editing = |
||
Line 35: | Line 50: | ||
If you replace ARTICLE with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet. |
If you replace ARTICLE with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet. |
||
− | To get more detailed information you can refer to the user's manual: |
+ | <blockquote>To get more detailed information you can refer to the user's manual: |
− | [https://www.mediawiki.org/wiki/Help:Starting_a_new_page Help: Starting a new page] |
+ | [https://www.mediawiki.org/wiki/Help:Starting_a_new_page Help: Starting a new page]</blockquote> |
== How to edit a page? == |
== How to edit a page? == |
||
Line 44: | Line 59: | ||
Note that only the authorized users are able to edit the content. |
Note that only the authorized users are able to edit the content. |
||
− | Here you can get more information about the editing process: [https://www.mediawiki.org/wiki/Help:Editing_pages Help:Editing pages] |
+ | <blockquote>Here you can get more information about the editing process: [https://www.mediawiki.org/wiki/Help:Editing_pages Help:Editing pages]</blockquote> |
== How to work with text and its structuring? == |
== How to work with text and its structuring? == |
||
− | Detailed user guide on text formatting: [https://en.wikibooks.org/wiki/MediaWiki_User_Guide MediaWiki: User guide] |
+ | <blockquote>Detailed user guide on text formatting: [https://en.wikibooks.org/wiki/MediaWiki_User_Guide MediaWiki: User guide]</blockquote> |
=== How to structurize a text? === |
=== How to structurize a text? === |
||
Line 78: | Line 93: | ||
The maximum level of a heading is 6, rendered using <nowiki>======Heading L6======</nowiki>. Entering a heading with 7 equals-signs such as <nowiki>=======Heading L7=======</nowiki> results in the creation of a heading of the level 6, with one equal-sign becoming part of the text of the heading: "=Heading L7=". |
The maximum level of a heading is 6, rendered using <nowiki>======Heading L6======</nowiki>. Entering a heading with 7 equals-signs such as <nowiki>=======Heading L7=======</nowiki> results in the creation of a heading of the level 6, with one equal-sign becoming part of the text of the heading: "=Heading L7=". |
||
− | See more details here: [https://en.wikibooks.org/wiki/MediaWiki_User_Guide/Sections_and_Headings MediaWiki user guide: sections and headings] |
+ | <blockquote>See more details here: [https://en.wikibooks.org/wiki/MediaWiki_User_Guide/Sections_and_Headings MediaWiki user guide: sections and headings]</blockquote> |
=== How to format text? === |
=== How to format text? === |
||
Line 146: | Line 161: | ||
=== How to work with lists? === |
=== How to work with lists? === |
||
− | |||
− | Lists formatting: |
||
Bullet lists: |
Bullet lists: |
||
Line 222: | Line 235: | ||
* External links to pages at other websites |
* External links to pages at other websites |
||
− | + | ''' Internal hyperlinks ''' |
|
{| class="wikitable" |
{| class="wikitable" |
||
Line 244: | Line 257: | ||
|} |
|} |
||
− | + | ''' External hyperlinks ''' |
|
{| class="wikitable" |
{| class="wikitable" |
||
Line 254: | Line 267: | ||
|} |
|} |
||
− | You can also fing some more details here: [https://www.mediawiki.org/wiki/Help:Links Help: links] |
+ | <blockquote>You can also fing some more details here: [https://www.mediawiki.org/wiki/Help:Links Help: links]</blockquote> |
== How to format tables? == |
== How to format tables? == |
||
Line 285: | Line 298: | ||
|} |
|} |
||
− | Basics: [https://en.wikibooks.org/wiki/MediaWiki_User_Guide/Tables MediaWiki User guide: Tables] |
+ | <blockquote>Basics: [https://en.wikibooks.org/wiki/MediaWiki_User_Guide/Tables MediaWiki User guide: Tables]</blockquote> |
− | Advanced: [https://en.wikipedia.org/wiki/Help:Table Wiki: Tables] |
+ | <blockquote>Advanced: [https://en.wikipedia.org/wiki/Help:Table Wiki: Tables]</blockquote> |
== How to work with math formulas? == |
== How to work with math formulas? == |
||
Line 374: | Line 387: | ||
</syntaxhighlight> |
</syntaxhighlight> |
||
</pre> |
</pre> |
||
− | |||
gives: |
gives: |
||
<syntaxhighlight lang="python" line> |
<syntaxhighlight lang="python" line> |
||
Line 384: | Line 396: | ||
return arr |
return arr |
||
else: |
else: |
||
⚫ | |||
− | pass |
||
⚫ | |||
− | + | <blockquote>See the documentation of the syntaxhighlight-extension here: [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight Syntax highlight]</blockquote> |
|
== How to add TikZ-flowchart? == |
== How to add TikZ-flowchart? == |
||
Line 393: | Line 404: | ||
With the use of the special extension you can embed the TikZ-flowchart written in LaTex directly to your page within the tag <pre><PGTikZ></pre>. |
With the use of the special extension you can embed the TikZ-flowchart written in LaTex directly to your page within the tag <pre><PGTikZ></pre>. |
||
For examle, the following code |
For examle, the following code |
||
− | <pre> |
+ | <pre><PGFTikZ> |
⚫ | |||
[[File:My_image_1.png|400px|test image]] |
[[File:My_image_1.png|400px|test image]] |
||
Line 429: | Line 439: | ||
</pre> |
</pre> |
||
⚫ | |||
⚫ | |||
+ | [[File:My_image_1.png|400px|test image]] |
||
+ | |||
+ | <PGFTikZPreamble> |
||
+ | |||
+ | \usepackage{tikz} |
||
+ | \usetikzlibrary{arrows} |
||
+ | \usetikzlibrary{intersections} |
||
+ | \usetikzlibrary{calc} |
||
+ | |||
+ | </PGFTikZPreamble> |
||
+ | \begin{tikzpicture}[scale=.8,every node/.style={minimum size=1cm}] |
||
+ | % |
||
+ | \begin{scope}[ |
||
+ | yshift=-83,every node/.append style={ |
||
+ | yslant=0.5,xslant=-1},yslant=0.5,xslant=-1 |
||
+ | ] |
||
+ | \draw[step=4mm, black] (0,0) grid (5,5); |
||
+ | \draw[black,thick] (0,0) rectangle (5,5);%borders |
||
+ | \fill[green] (2.05,2.05) rectangle (2.35,2.35); % center pixel |
||
+ | \fill[green] (1.65,2.05) rectangle (1.95,2.35); %left |
||
+ | \fill[green] (2.45,2.05) rectangle (2.75,2.35); %right |
||
+ | \fill[green] (2.05,2.45) rectangle (2.35,2.75); %top |
||
+ | \fill[green] (2.05,1.95) rectangle (2.35,1.65); %bottom |
||
+ | |||
+ | \end{scope} |
||
+ | % |
||
+ | % draw annotations |
||
+ | % |
||
+ | \draw[-latex,thick,green](-3,-2)node[left]{1 patch} |
||
+ | to[out=0,in=200] (-1,-.9); |
||
+ | \end{tikzpicture} |
||
+ | </PGFTikZ> |
||
+ | |||
⚫ | |||
== How to paste pictures? == |
== How to paste pictures? == |
||
Mediawiki supports the use of images in various formats. In order to be used in a wiki, image first needs to be uploaded. To upload the picture please use the link "Upload file" in the left menu column of the page and follow the certain instructions. |
Mediawiki supports the use of images in various formats. In order to be used in a wiki, image first needs to be uploaded. To upload the picture please use the link "Upload file" in the left menu column of the page and follow the certain instructions. |
||
− | |||
The following is an overview of placing images into pages, such images that have already been uploaded. |
The following is an overview of placing images into pages, such images that have already been uploaded. |
||
Line 461: | Line 504: | ||
|} |
|} |
||
− | To know about other feature please refer to: [https://en.wikibooks.org/wiki/MediaWiki_User_Guide/Images MediaWiki User Guide: images] |
+ | <blockquote>To know about other feature please refer to: [https://en.wikibooks.org/wiki/MediaWiki_User_Guide/Images MediaWiki User Guide: images]</blockquote> |
== How to embed a Google document into mediawiki page? == |
== How to embed a Google document into mediawiki page? == |
||
Special extension allows to embed Google Docs' spreadsheets into the wiki page. |
Special extension allows to embed Google Docs' spreadsheets into the wiki page. |
||
− | |||
− | <!--T:5--> |
||
Supported parameters are: |
Supported parameters are: |
||
− | </translate> |
||
− | |||
{| class="wikitable" |
{| class="wikitable" |
||
! Name !! Default |
! Name !! Default |
||
Line 481: | Line 520: | ||
|} |
|} |
||
− | <translate> |
||
− | <!--T:6--> |
||
As an example using all of the parameters: |
As an example using all of the parameters: |
||
− | </translate> |
||
+ | <pre><googlespreadsheet width="600" height="200" style="width:50%">Google Docs' key goes here</googlespreadsheet></pre> |
||
− | <code class="mw-code mw-highlight" style="display:block"><!-- |
||
− | -->{{^(}}{{#tag:span|googlespreadsheet|class=nt}} {{attr|width|"600"}} {{attr|height|"200"}} {{attr|style|"width:50%"}}{{)^}}<translate><!--T:7--> Google Docs' key goes here</translate>{{^(}}/{{#tag:span|googlespreadsheet|class=nt}}{{)^}} |
||
− | </code> |
||
To actually embed a spreadsheet, the spreadsheet needs to be published with Google's '''File''' > '''Publish to Web...''' option. It is not sufficient to just have a shareable link. |
To actually embed a spreadsheet, the spreadsheet needs to be published with Google's '''File''' > '''Publish to Web...''' option. It is not sufficient to just have a shareable link. |
||
Line 496: | Line 530: | ||
== How to import content? == |
== How to import content? == |
||
− | + | ''' From Latex file ''' |
|
⚫ | |||
+ | To upload your syllabus from Latex to MediaWiki use the toolkit developed by our students: |
||
− | === From Word document === |
||
⚫ | |||
− | == How to export content? == |
||
− | + | == How to export content? == |
|
=== To PDF-file === |
=== To PDF-file === |
||
+ | To get a printable version of the certain page use the link '''Printable version''' at the left column of the page. After the page is generated you may print it as usually. |
||
− | === Printing === |
Latest revision as of 10:56, 14 December 2021
Introduction to MediaWiki
The MediaWiki software is used by tens of thousands of websites and thousands of companies and organizations. It powers Wikipedia and also this website. MediaWiki helps you collect and organize knowledge and make it available to people. It's powerful, multilingual, free and open, extensible, customizable, reliable, and free of charge.
The structure of the content
Structure of syllabi
Core courses The lists of the core courses are placed here:
Elective courses
The lists of the elective courses are placed here:
Structure of Teaching Regulation Document
Overall teaching regulation can be found here:
Individual instructors' pages
By the following link you can find your personal instructor's page, edit it or create, if necessary. It's highly recommended to preserve common structure of the page during editing.
Content editing
How to log in the system?
Use your regular credentials for this purpose: user@innopolis.ru and the password from your account. If you cannot log in, please contact the IT-department @iuithelp
How to create a page?
From the search box If you search for a page that doesn't exist, then you will be provided with a link to create the new page.
Using the URL You can use the wiki's URL for creating a new page.
The URL to an article of the wiki is usually something like this:
If you replace ARTICLE with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet.
To get more detailed information you can refer to the user's manual: Help: Starting a new page
How to edit a page?
Clicking the "Edit" page tab at the top of the page will take you to the edit page for that article, where you can create the new page by typing your text, and clicking submit. Moreover, if you need not edit the whole page but only its part, you can click on "Edit" link related to this certain part and work only with it. If the text is so long it helps to save a time.
Note that only the authorized users are able to edit the content.
Here you can get more information about the editing process: Help:Editing pages
How to work with text and its structuring?
Detailed user guide on text formatting: MediaWiki: User guide
How to structurize a text?
Headings are created using sequences of "=" characters, placed before the heading title and after the heading title, on the same line. The level of headings is determined by the number of "=" characters.
Examples:
Level | Example |
---|---|
2. | ==Plants== |
3. | ===Plants=== |
4. | ====Plants==== |
Start level: 2
Do not use headings of level 1, such as "=Title="; start with level 2 instead. The heading at level 1 is used for the title of the page.
Maximum level: 6
The maximum level of a heading is 6, rendered using ======Heading L6======. Entering a heading with 7 equals-signs such as =======Heading L7======= results in the creation of a heading of the level 6, with one equal-sign becoming part of the text of the heading: "=Heading L7=".
See more details here: MediaWiki user guide: sections and headings
How to format text?
The following is an overview of text formatting available in Mediawiki:
Formatting | Markup | Note |
---|---|---|
Boldface | '''text'''
|
|
Italics | ''text''
|
|
Boldface and italics | '''''text'''''
|
|
Boldface combined with wikilink | '''[[text]]'''
|
The reverse order of ticks and brackets does not work: [['''text''']]
|
Other text formatting such as underline or blockquote needs to be done using HTML tags, including U for underline, TT for typewriter text, S for strikethrough, SUB for lower index and SUP for upper index.
How to use HTML tags?
Text formatting can also be done using HTML and CSS. Some of the most useful HTML elements are:
Task | Markup | Note |
---|---|---|
Preformatted text | <pre>
preformatted
</pre>
|
The effect in wiki differs from the one in HTML; in wiki, the text within the PRE element is treated as within NOWIKI element, leaving all the HTML and wiki markup uninterpreted. |
Blockquote | <blockquote>Longer passage.</blockquote>
| |
Comments | <!-- comment -->
|
Avoid nesting, such as <!-- <!-- comment --> -->
|
Generic inline element | <span style="TODO"></span>
|
Can be styled arbitrarily using cascading style sheets - CSS. |
Generic block element | <div style="TODO"></div>
|
Can be styled arbitrarily using cascading style sheets - CSS. |
Some HTML elements are not allowed, such as A and IMG.
How to work with lists?
Bullet lists:
Example Syntax | Example Output |
---|---|
* a ** b ** c *** d |
|
Numbered lists:
Example Syntax | Example Output |
---|---|
# a ## b ## c ### d |
|
Definition lists:
Example Syntax | Example Output |
---|---|
; defined term : definition ; defined term 2 : definition 2 |
|
Mixed lists:
Example Syntax | Example Output |
---|---|
* a *# b *# c |
|
How to insert a link?
There are five types of hypertext links in MediaWiki, but two of them are the mostly used:
- Internal links to other pages in the same wiki (commonly called "wikilinks")
- External links to pages at other websites
Internal hyperlinks
Task | Markup |
---|---|
Internal hyperlink | [[keyword]] |
Internal hyperlink to a section | [[keyword#section_heading|link title]] |
Internal hyperlink showing a different word | [[keyword|its appearance]] |
Internal hyperlink with a tooltip | [[keyword|<span title="A tooltip">its appearance</span>]] |
Internal hyperlink in bold | '''[[keyword]]''' |
External hyperlinks
Task | Markup |
---|---|
External hyperlink | [URL_containing_no_spaces title of the URL] |
You can also fing some more details here: Help: links
How to format tables?
The following code
{| class="wikitable" style="height:14em;" |- ! Left !! Center !! Right |- | Top left cell || Top center cell || Top right cell |- style=height:7em | Middle left cell || Middle center cell || Middle right cell |- | Bottom left cell || Bottom center cell || Bottom right cell |}
gives the following:
Left | Center | Right |
---|---|---|
Top left cell | Top center cell | Top right cell |
Middle left cell | Middle center cell | Middle right cell |
Bottom left cell | Bottom center cell | Bottom right cell |
Basics: MediaWiki User guide: Tables
Advanced: Wiki: Tables
How to work with math formulas?
You can enter mathematical formulas into a wiki, using a math
tag, such as:
<math>\sqrt{2}</math>
The formulas are marked up in the TeX markup, the markup of a complex typesetting system specialized on mathematics.
To get started, follow the examples below.
No. | Desired Effect | Markup |
---|---|---|
1. | <math>\alpha</math>
| |
2. | <math>\sqrt{2}</math>
| |
3. | <math>\sqrt{1-e^2}</math>
| |
4. | <math>\frac{2}{4}=0.5</math>
| |
5. | <math>\sum_{k=1}^N k^2</math>
| |
6. | <math>\int\limits_{1}^{3}\frac{e^3/x}{x^2}\, dx</math>
| |
7. | <math>\begin{bmatrix}
0 & \cdots & 0 \\
\vdots & \ddots & \vdots \\
0 & \cdots & 0
\end{bmatrix}</math>
| |
8. | <math>\begin{pmatrix}
x & y \\
z & v
\end{pmatrix}</math>
|
How to put a source code?
The following code:
<syntaxhighlight lang="python" line> def quick_sort(arr): less = [] pivot_list = [] more = [] if len(arr) <= 1: return arr else: pass </syntaxhighlight>
gives:
def quick_sort(arr):
less = []
pivot_list = []
more = []
if len(arr) <= 1:
return arr
else:
pass
See the documentation of the syntaxhighlight-extension here: Syntax highlight
How to add TikZ-flowchart?
With the use of the special extension you can embed the TikZ-flowchart written in LaTex directly to your page within the tag
<PGTikZ>
.
For examle, the following code
<PGFTikZ> [[File:My_image_1.png|400px|test image]] <PGFTikZPreamble> \usepackage{tikz} \usetikzlibrary{arrows} \usetikzlibrary{intersections} \usetikzlibrary{calc} </PGFTikZPreamble> \begin{tikzpicture}[scale=.8,every node/.style={minimum size=1cm}] % \begin{scope}[ yshift=-83,every node/.append style={ yslant=0.5,xslant=-1},yslant=0.5,xslant=-1 ] \draw[step=4mm, black] (0,0) grid (5,5); \draw[black,thick] (0,0) rectangle (5,5);%borders \fill[green] (2.05,2.05) rectangle (2.35,2.35); % center pixel \fill[green] (1.65,2.05) rectangle (1.95,2.35); %left \fill[green] (2.45,2.05) rectangle (2.75,2.35); %right \fill[green] (2.05,2.45) rectangle (2.35,2.75); %top \fill[green] (2.05,1.95) rectangle (2.35,1.65); %bottom \end{scope} % % draw annotations % \draw[-latex,thick,green](-3,-2)node[left]{1 patch} to[out=0,in=200] (-1,-.9); \end{tikzpicture} </PGFTikZ>
See the instructions here: PGTikZ
How to paste pictures?
Mediawiki supports the use of images in various formats. In order to be used in a wiki, image first needs to be uploaded. To upload the picture please use the link "Upload file" in the left menu column of the page and follow the certain instructions.
The following is an overview of placing images into pages, such images that have already been uploaded.
Task | Markup | Default Frame | Note |
---|---|---|---|
Image | [[Image:image_name.png]] | No | The image is shown in its full size as found in the file. |
Image with thumb | [[Image:image_name.png|thumb|A caption text of the image.]] | Yes | Thumbs are always scaled down so as not to exceed an upper limit on the size. |
Image without thumb, with restricted size | [[Image:image_name.png|150px]] | No |
To know about other feature please refer to: MediaWiki User Guide: images
How to embed a Google document into mediawiki page?
Special extension allows to embed Google Docs' spreadsheets into the wiki page.
Supported parameters are:
Name | Default |
---|---|
width | 500 |
height | 300 |
style | width:100% |
As an example using all of the parameters:
<googlespreadsheet width="600" height="200" style="width:50%">Google Docs' key goes here</googlespreadsheet>
To actually embed a spreadsheet, the spreadsheet needs to be published with Google's File > Publish to Web... option. It is not sufficient to just have a shareable link.
Content import / export
How to import content?
From Latex file
To upload your syllabus from Latex to MediaWiki use the toolkit developed by our students:
How to export content?
To PDF-file
To get a printable version of the certain page use the link Printable version at the left column of the page. After the page is generated you may print it as usually.