This shows you the differences between two versions of the page.
wiki:mcneel:formatingwiki [2014/11/21] |
wiki:mcneel:formatingwiki [2020/08/14] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Guidelines for Formatting McNeel Wiki Pages ====== | ||
+ | Here are guidelines for creating new wiki pages. By following these suggestions, | ||
+ | |||
+ | There are two keys to creating searchable wiki pages: | ||
+ | - Page location in the Namespaces | ||
+ | - The highest level headline on the page. | ||
+ | |||
+ | ===== Page Location ===== | ||
+ | |||
+ | Wiki pages are named in Nested [[http:// | ||
+ | |||
+ | http:// | ||
+ | |||
+ | This will create keywords rhino, 5, video, troubleshooting, | ||
+ | |||
+ | Do not rely on the title of the page itself for keywords. | ||
+ | |||
+ | Troubleshooting PDF Export in Rhino 5 | ||
+ | |||
+ | http:// | ||
+ | |||
+ | Do not: | ||
+ | - Combine tags in the same space. Rhino5 should be Rhino/ | ||
+ | - If it is a page that applies to one version of Rhino, include that in the namespace. | ||
+ | - The title of the page is a separate issue from the headline on the page itself and is covered below. | ||
+ | |||
+ | > | ||
+ | |||
+ | ===== Page Titles ===== | ||
+ | |||
+ | Pages need to have a formatted headline of H1 or H2. This is the text that will serve as the title of the page in searches. | ||
+ | |||
+ | Titles should not be duplicated. Look in the sitemap for existing titles on the wiki: http:// | ||
+ | |||
+ | The page headline can be changed at anytime without changing the namespace. | ||
+ | |||
+ | ===== Using the Sitemap to check organization of many pages===== | ||
+ | |||
+ | A good tool to see the organization of the wiki is to use the [[http:// | ||
+ | |||
+ | The bold red is the namespace organization. | ||
+ | |||
+ | {{: |