APL Wiki:About: Difference between revisions

Jump to navigation Jump to search
4,474 bytes removed ,  12:34, 4 November 2019
Miraheze>Marshall
m (→‎APL code blocks: Lowercase ngn/apl)
Miraheze>Adám Brudzewsky
Line 7: Line 7:
We welcome any and all contributions to APL Wiki, as long as they adhere to the general content standard as observed in existing pages. Currently, many links lead to [[Special:WantedPages|pages that as of yet do not exist]]. Creating and populating these missing pages is especially appreciated.
We welcome any and all contributions to APL Wiki, as long as they adhere to the general content standard as observed in existing pages. Currently, many links lead to [[Special:WantedPages|pages that as of yet do not exist]]. Creating and populating these missing pages is especially appreciated.


MediaWiki documentation applies. Especially useful for you as a contributor are:
MediaWiki documentation applies. Especially useful for you as a (new) contributor are:


* [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Editing_pages Editing pages]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Editing_pages Editing pages]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Starting_a_new_page Starting a new page]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Starting_a_new_page Starting a new page]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Links Links]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Formatting Formatting], but please follow the below guidelines.


=== Inline APL code ===
Keep these rules in mind:


Inline code is used for single primitives and short expressions and uses the format
* Make sure your changes are accurate. If you think something needs explaining but you're not 100% sure what the explanation should be, mention it on the page's Discussion tab.
* Avoid "thread mode", where you simply add your thoughts to a page without taking the trouble to make the page a unified whole. Thread mode is OK in Forums but not in documentation.
* Follow our [[APL Wiki:formatting|formatting]] guidelines.


<blockquote><pre><source lang=apl inline>(2=+⌿0=N∘.|N)/N←⍳100</source></pre></blockquote>
In the discussion tab, your voice is just one of many and you are free to express yourself as you wish.
which results in
<blockquote><source lang=apl inline>(2=+⌿0=N∘.|N)/N←⍳100</source></blockquote>
 
=== APL code blocks ===
 
For session transcripts, function definitions and lorger expressions, use code blocks like
 
<blockquote><pre><source lang=apl>
      (2=+⌿0=N∘.|N)/N←⍳100
2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97
</source></pre></blockquote>
 
which results in:
 
<blockquote><source lang=apl>
      (2=+⌿0=N∘.|N)/N←⍳100
2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97
</source></blockquote>
 
 
Optionally, you can indicate one or more APL dialects which are able to run the code by using a special template immediately after the source tag, like
 
<blockquote><pre><source lang=apl>
      {(2=+⌿0=⍵∘.|⍵)/⍵}⍳100
2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97
</source>
{{Works in|[[Dyalog APL]], [[dzaima/APL]], [[GNU APL]], [[ngn/apl]]}}</pre></blockquote>
 
which results in:
 
<blockquote><source lang=apl>
      {(2=+⌿0=⍵∘.|⍵)/⍵}⍳100
2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97
</source>
{{Works in|[[Dyalog APL]], [[dzaima/APL]], [[GNU APL]], [[ngn/apl]]}}</blockquote>
 
You can also include a permalink to [[TryAPL]], [[Try It Online]], ''repl.it'', or ''n9n.gitlab.io'' right before the source tag, for example
 
<blockquote><pre>[https://tryapl.org/?a=%7B%282%3D+%u233F0%3D%u2375%u2218.%7C%u2375%29/%u2375%7D%u2373100&run Try it now!]
<source lang=apl>
      {(2=+⌿0=⍵∘.|⍵)/⍵}⍳100
2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97
</source></pre></blockquote>
 
which results in:
 
<blockquote>
[https://tryapl.org/?a=%7B%282%3D+%u233F0%3D%u2375%u2218.%7C%u2375%29/%u2375%7D%u2373100&run Try it now!]
<source lang=apl>
      {(2=+⌿0=⍵∘.|⍵)/⍵}⍳100
2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97
</source></blockquote>
 
=== Primitives and other built-ins ===
 
When creating a page for a [[primitive function]], [[primitive operator|operator]], or [[quad name]], begin the page with the following template:
 
<blockquote><pre>{{Built-in|Log|⍟}}</pre></blockquote>
 
This inserts the text
 
<blockquote>{{Built-in|Log|⍟}}</blockquote>
 
and also inserts a nice big illustration of the [[glyph]] on the page:
 
At the bottom such pages, include <code><nowiki>{{APL built-ins}}</nowiki></code> and [{{fullurl:Template:APL_built-ins_body|action=edit}} edit that template's content] if the page you're creating isn't already listed there.
 
=== Dialects ===
 
Begin your page about an APL dialect with the ''Infobox array language'' info box. These are all the optional parameters it supports:
 
<blockquote><pre>
{{Infobox array language
| title =
| developer =
| released =
| latest release version =
| withdrawn =
| array model =
| index origin =
| function styles =
| numeric types =
| unicode support =
| file ext =
| implementation language =
| implementation languages =
| platform =
| platforms =
| operating system =
| operating systems =
| license =
| website =
| download =
| documentation =
| influenced by =
| influenced =
}}</pre></blockquote>
Have a look at the existing dialect pages, e.g. [[Dyalog APL]], to see how these values are used, Try to fill in as many as you can (but use only one of each singular/plural pair). You only need to use <code>title</code> if the language title differs from the page title (e.g. for technical reason like the inability to create a page that begins with a lowercase letter). In that case, you may also want to begin the page with <code><nowiki>{{Actually|real name}}</nowiki></code> where <code>real name</code> should be the proper name of the dialect.
 
At the bottom of the page, include <code><nowiki>{{APL programming language}}</nowiki></code> and [{{fullurl:Template:APL_programming_language_body|action=edit}} edit that template's content] if the dialect you're creating a page about isn't already listed there.
 
=== Mentioning subjects that have their own page ===
 
It is fine for a page to have a section about a subject that also has its own page. When that happens, begin the section with <code><nowiki>{{Main|subject}}</nowiki></code> where <code>subject</code> is the target page title. Don't include double brackets (as a page link) — it is done for you.
 
=== Pages about People, organisations, and what they do ===
 
Insert <code><nowiki>{{APL community}}</nowiki></code>  at the very bottom of the page, and [{{fullurl:Template:APL_community_body|action=edit}} edit that template's content] if the page you're creating isn't already listed there.


== External links ==
== External links ==

Navigation menu