DSP Wiki:Plan

From the Dyson Sphere Program Wiki
Revision as of 19:16, 11 January 2021 by imported>76561198018895007 (→‎Cards)

The Plan

Here, we will attempt to outline the overall plan for DSP Wiki

UI/UX

The aim for the UI/UX (aka "Skin" in Mediawiki terms, "Theme" is another good word) is to be as similar to the in-game UI as possible. In particular:

  • Color scheme: "Dark" theme, colors shifted to match game colors (light blue #d1ffff and/or orange #f3a602). The currently used orange theme is NOT the final product, it is borrowed from another wiki.
  • The page content area will be transitioned to look similar to the various windows in the game. Goal is to replicate the Inventory window, with the upper-left "folder tab" housing the page title, and the upper-right "close window" area being replaced by page status/notification icons, and action links. The CSS for this is tricky, but work is ongoing.
  • Considering using in-game mouse cursor as well
  • DO NOT apply excessive CSS in-line or in-page unless it is absolutely necessary. Especially try to avoid overriding site-wide CSS, except for special circumstances. Doing so makes it incredibly difficult to go back and update the Skin when necessary. This especially applies to background colors.
  • Templates should be used for most CSS overrides, when possible. This allows us to make the change in one place, and affect all instances.


Cards

We are working on using "cards" to compartmentalize information. For example, the front page will have a Card for each main category (Gameplay, Items, Technologies, etc.) and each will have a brief text description and link either to the Category page for that topic, or an actual page, depending. The category pages will then have Cards breaking them down similarly, etc. Cards will be created using Templates to make things easier, but for now, adding information to pages without the use of cards is acceptable.

Images

  • Until after the game officially launches into Early Access on Steam, please do not upload any images from in the game. There is a process in place that will import a lot of images shortly after launch, which have been prepared in advance for the highest quality possible. That process will break if an image already exists with the same name.
  • Images should be the highest quality possible, and lowest file size obtainable. Different formats apply for different purposes. JPG is best for images with a lot of color transitions, e.g. screenshots of the game itself. PNG works best for simpler images with areas of solid color, and for transparent backgrounds.
  • Whenever possible, images such as icons or other elements of UI, should have transparent backgrounds. This allows them to be layered on other elements and to adapt to potential changes in the Wiki color scheme.

Pages

  • If you think it deserves its own page, you're probably right. Go ahead and create a page, we can merge it elsewhere later on if needed.
  • At first, there will be many pages marked "Stub". These are put in place merely to start mapping out the wiki and giving others a starting point. These pages may contain instructions within them of how they are envisioned to be used.
    • You can use the {{Stub}} template to mark a page as Stub.
  • If you plan to add a great deal of content to a page, please be sure to mark it as {{WIP}}. Moving it to a User/Sandbox page is optional, but encouraged.
  • Every item, technology, upgrade, etc. should get its own page. This helps them show up when Searching the wiki, as well as on Google when it indexes the Wiki.

Templates

  • We are evaluating templates from other wikis for import to DSP Wiki. Templates are quite a big beast to tackle, as many rely on other templates or LUA modules and just importing one could result in requiring dozens more. Each required one must be evaluated for whether it is needed on our Wiki. If you have a desire for a template to do something, file a request and we'll look into it. If you're experienced with MediaWiki Template creation, this is an area we can use a lot of help!
  • we want to avoid having a billion highly specialized templates, but not at the expense of usefulness and ease of maintaining a unified wiki.

Categories

  • A wiki of this type doesn't require a great deal of categories, but we'd like to sub-categorize as much as possible. For example, the "Items" Category should ultimately contain all items available in the game, but as with the game, it should be sub-categorized at least to "Buildings" and "Components", and possibly even further, such as "Assemblers" "Resource Extractors" and "Logistics" under buildings, etc.
  • Remember to add a brief description to new categories, so that they get a page and don't show as a broken link
  • Ultimately, Categories should be intuitive to the average game player, and follow a logical path - see "Cards" under "UI/UX" for more on why.
🍪 We use cookies to keep session information to provide you a better experience.