Journal: Prep Material - bcb420-2023/Angela_Uzelac GitHub Wiki

Wiki - Editing

Overview

  • intro to authoring Wikitext, structure of Wikis, pages live in "Namespaces"
  • markup conventions like Wikitext markup
  • how to keep organized, add Creative Commons Attribution License and why it's used
  • extensions on Wiki
  • create pages and add them to categories (make sure it's in own user space)
  • create page stubs for journal and make Insights! page
  • for formatting help: https://meta.wikimedia.org/wiki/Category:Moved_to_MediaWiki

Editing

  • can edit any page you have access to, can edit Student Wiki
  • click Edit at edges of page, takes you to editable source code, can see previews
  • 2 apostrophes to emphasize text, 3 to emphasize more, 5 to emphasize most
  • empty line starts a new paragraph
  • break lines using
  • characters at beginning of line:
  • hashtag for numbered list
  • star for bullet
  • ; for term
  • : for definition
  • can use HTML tags: https://www.mediawiki.org/wiki/Help:HTML_in_wikitext
  • links in
  • footnote like link ^[]
  • using "TOC" to force placing table of contents at position of this magic word, suppress with NOC (with double underscore in front and behind
  • header levels defined by the number of = characters before and after the header text

Namespaces

  • collection of pages
  • behaviour of the software can be customized for different namespaces
  • ex: can edit in the main and user namespace but not in the MediaWiki namespace where pages are held that affect the functioning of the wiki
  • page names without prefix live in main space, common prefixes:
  1. User: - personal pages for user with an account on the Wiki;
  2. Talk: - discussion pages for comments on pages, accessible via the “Discussion” tab;
  3. Help: - this page for example;
  4. Template: - pages with reusable text.
  5. Special: - pages that implement special functionality (like login, user lists, or lists of recently changed pages);
  6. Category: - an index of pages that have been given a common tag. This is a convenient way to access pages that are in some way related;

Categories

  • once page edited, can associate it with categories
  • add appropriate category tag by typing ex: Category:BCH441_2013
  • page is then automatically linked from a page that collects all pages with that category tag (don't make new ones)

User space

  • Namespaces allow us to distinguish pages that share the same logical name
  • Every student will create a journal page, but there can be only one Journal page on the Wiki
  • so, each of these pages needs a distinct name, solution: keep them in the User: namespace, and create them as subpages of everyone’s User page
  • page name of your user page is User:; subpages are created with a backslash, and therefore your Course Journal page should be User:/Journal
  • don't create pages in the “Main space” of the Student Wiki, don't omit the User:/ part of the page name

Copyright

  • All material submitted for credit must be licensed with an appropriate open-source license
  • For code - MIT software license, for everything else - Creative Commons Attribution 4.0 International License
  • The MIT license for code guarantees that there are no restrictions on re-use other than fair and visible attribution of the authors’ work. The CC license guarantees proper attribution of authorship but allows free use otherwise
  • Enter the template code {{CC-BY}} to create the copyright message: This copyrighted material is licensed under a Creative Commons Attribution 4.0 International License.