2021.05.27 2021.06.10 Amenoum MATERRA documentation. dox 1 MATERRA Documentation Setup
NOTE: MATERRA should be installed in a root directory of a domain or a subdomain, otherwise it will be necessary to manually modify file references (links) in js files.
1. Copy the contents of the public_html folder to your website root directory (generally public_html),
2. if you plan to use user registration, copy [the empty] materra_db folder to the same directory holding the public_html folder (or update users/users.settings.inc.php DB_USERS constant with a path where you want users database to be stored),
3. run setup.php (ie. by visiting https://yourwebsite.org/setup.php where yourwebsite.org should be replaced with your domain or subdomain name).
Optional (changing settings): Changing settings (for cache, etc.) is done by editing files ending with settings.inc.php (ie. check.settings.inc.php). Each such file affects only specific function or area of the website (ie. check.settings.inc.php provides settings for check.php which is used to check for updates, one can open .php files in a text editor to see what they are used for). One may also want to edit files ending with header.inc.php, as these contain webpage headers.
log_datedate of article creation
log_updatedate of last updateby default, this is filled automatically and should be left empty
log_mtimefile modification dateby default, this is filled automatically and should be left empty
log_authorauthor namecan contain additional tags - log_address and log_email, specifying affiliation or address and email, this data is used in LaTeX generation.
In case of multiple authors, use one log_author tag for each author.
log_descshort description of the workuseful if writing a log type webpage, this will then be used in log index
log_categorycategoryuseful for log type webpages, used in log index if categories are enabled
log_keywordswords to highlightcase sensitive, these phrases will be highlighted (bold) in the article
log_clsdocument class, ie. articleused in LaTeX generation
cite_yearyear of publicationused for citations, by default, year will be extracted from log_update or log_date, so it is unnecessary to specify this if log_date is specified
cite_doialternative link to articleused for citations
cite_contriban address for contributionsthis can be a wallet or web (URL) address for support
set_body_numberingcontrols auto-numbering of chaptersset to 0 to turn off automatic numbering
Defining title and subtitle A title and subtitle should be defined like this: Here, div tag, containing the subtitle, is optional. Writing content After title definition, article content should be enclosed in a spirit tag, like this: Use sub1 tag for main chapters and sub2 and sub3 tags for sub-chapters. The no_numbering attribute is optional and it will leave the chapter unnumbered. Tag sub2 should always follow after sub1, while sub3 should always follow after sub2, otherwise the system might get confused. For synonyms, just use the = sign, as shown in the example. Content will be formatted automatically. To start a new paragraph, start the sentence on a new line and make sure there is one empty space character after the last sentence. Writing equations To write equations, use the e tag and mathjax (tex/latex) syntax. Ie. this: will produce: $\displaystyle E = {m \over \sqrt{1 - {\beta}^2}} c^2$ References Use a html tag for references, ie.: will produce:

For more consult Yukawa, Proca

Here, href attribute is used for a link to cited work. The attribute should be present for offline works too, but it should be left empty in that case (href=""). The attribute data-notitle set to 1 signals the engine to use content specified in title attribute when generating references, rather than the content of a tag (Yukawa, Proca). For regular links add attribute noref with value of 1 to the a tag (noref="1"). Lists and tables Use ul html tag for unnumbered (bulleted) lists, ol tag for numbered lists and table for tables, ie.: produces:
• item 1
• item 2
1. item 1
2. item 2