Adding to the Wiki Site
Halito! Welcome to the wiki site. Here’s a brief overview on how to add content to this site.
The Block Editor
This site’s content is powered by the block editor. There is a lot of flexibility and freedom with how the content is built, but the long and short of it is that the block editor gives you flexibility within some preset guidelines / boundaries. For example:
This is a paragraph block whose background color and text colors have been set with the block styles. While the choices are predetermined, you can choose what makes sense to you!
I recommend always having the “List View” open, as it helps keep track of blocks, but if you’re just writing a lot of content, that may be unnecessary.
Bonus Feature: Markdown Support
The block editor (sometimes referred to as “Gutenberg”) also supports markdown! You can use basic markdown (like backticks for code or # for heading levels) as some keyboard shortcuts for writing content.
Gotcha: Pasting from Microsoft Office
Pasting from Microsoft products is kind of the worst. It drops in a lot of extra styles and random hidden formats and overall it’s probably not that great of an experience. Beware if this is something you need to do!
The Table of Contents
The table of contents is automatically generated based on the heading levels you create. If you create a Group block and nest all of your content there, then the heading should also be highlighted. If you don’t use a group block, you can still use the table of contents as a quick nav.
Post Types
There are 2 post types for this site: Posts and Dev Notes. Posts are used for most things, and Dev Notes are used for developers.
Posts should always have a Category applied.
Hidden Content
Hiding content is easy! Use the “Content Permissions (Members)” metabox found below the Block Editor. Select the appropriate role. This requires users to be logged in and have the right permissions to view the content.
Code Blocks
Developers should generally use the 3rd party Code Snippet Block (instead of the default Code block) as this creates copyable snippets with language support.