bedrock-oss/bedrock-wiki

Rewrite of the Bedrock Wiki.

bedrock-wiki's Issues

Sidebar does not scroll properly when lots of sections are expanded

If you expand a lot of sections, the bottom of the sidebar is cut off, meaning its impossible to scroll to all content.

Theme-switcher cannot be clicked on the chevron

Can't click on orange area, which is most natural place to click:L

Address width on large-screen monitors.

Also gives us a chance to make space for a right-hand-based TOC. Relates to #14.

Light rounding on inline code-blocks

The rounding is pretty intense right now:

It doesn't need to be sharp-square, but right now it stands out, I think.

Create more markdown-friendly file-path display

Current version requires going through external editor, and leaves a very messy HTML block in the markdown. Can we somehow generate this more cleanly, for example embedding the external parser into the actual build pipeline?

Please note the 1.1 release milestone.

Show sidebar pip in-page as well

Currently we need to write it into the title, or add it below as a widget. Can we just make sidebar pips display in the title too?

Aggresive wrapping on titles, when labels are included

Titles are wrapping too aggressively when there is a label.

Invalid usage of CodeHeader

Link: https://bedrock-oss.github.io/bedrock-wiki-vite/documentation/emojis.html#custom-emoji

Add ability to add contributors over frontmatter

The idea here is to have something like the following in the front-matter:

contributors
 - github URL
 - github URL

This should get merged with the build-time contributors, so we can credit people who may have been lost from the git history.

Prevent unicode symbols from being parsed on Emoji Page

Page: https://bedrock-oss.github.io/bedrock-wiki-vite/documentation/emojis.html

Maybe not worth worrying about. Please note 1.1 milestone.

Sign up for proper Algolia Search

Mobile support

Currently, the sidebar hides in mobile view, but the hamburger menu can't be clicked, and generally the top bar gets quite cramped:

Port/create Table of Contents

The old-wiki had a really cool TOC that moved from top-of-page (mobile) to right-of-page (desktop).

Fix/style the Unicode-Converter on the Emojis page

This can also be just removed if you don't want to bother.

Adjust spacing across all elements for consistancy and readability

Remove old `index.md` from each category

For example https://bedrock-oss.github.io/bedrock-wiki-vite/concepts/index.html

Top-level categories in sidebar does not appear to have `nav_order`

CSS: Increase spacing above tables

Better collapsables

Currently collapsible are very meh. Can we do a Vue component?

Set to v1.1, even though I would love it in 1.0.

Design a kick-ass home-page

We are rebranding... lets show it!

Lets give some love to our home-page, and make it pop so people want to stay on the site.

Design Vue component for giving images visible titles

Please note 1.1 Milestone

Fix code headers

Some code block headers were transferred incorrectly and now need to be fixed.

Add visual indication that "copy" button works in code-blocks

Currently there is no visual feedback or animation to show the button was pressed.

Please note the v1.1 Milestone.

Make more interesting styling for checkboxes

@KaiFireborn I assigned you here, since this would mostly impact the guide, and I thought you might be interested. Feel free to remove yourself.

I also put it at v1.1 milestone, so there isn't any rush.

Design proper 404 page

Current 404 is just "HELLO YOU TOOK A WRONG TURN".

For example https://bedrock-oss.github.io/bedrock-wiki-vite/docume

Relates to #17

Add search

add searching

Vue Button Component

Create a button component that can be reused across the project with feedback upon click, support for mixed icon/text usage etc.

Make Vite the live site

Should we move into the old repo?

Just switch the domain registration over?

Fix light-theme background

Light-theme background is currently using pure-white, I think. We should set it to something more pleasing, to prevent Firefox (and other browers/plugins) from adjusting it.

The feature is intended to replace "bright white" loading screens, and generally should not edit a page unless its without CSS (like a plain-HTML website.

The error here is that we aren't styling it (leaving it white), so Firefox is treating it like a bright-white loading screen.

Rethink icon badges

For now, as far as I understood, the icons are:

• Graduate hat = Guide
• Chemistry glass = Recipe
• Warning sign = Experimental
• Left without icons: Beta, New

I think it should be like that:

• Graduate hat = Guide (left as it is)
• Chemistry glass = Experimental
• Warning sign = Beta OR something really unstable and dangerous OR deprecated
• Deprecated also can be represented as a tombstone

Also, I think it would be ok to use whole words for New and Beta, but without colorful badges

JQ Embeds have weird styling

Mobile support: Add header links into sidebar, or display them some other way.

Removing them from top bar was intentional, but we need to put them somewhere else.

Please note 1.1 Milestone.

Some form of image-sizing

Not sure how/if we want to approach this, but currently images can be as large as they want.

Create/Port contributors widget

Move tasks from readme, into github issues

Some tasks are finished, but not marked as complete. Verify completed tasks, then move them into issues. The readme can be edited at that time, to remove the list of open issues.

Please set everything to Milestone 1.0 release. I will groom later if some things can be done later.

Pixelated image-macro no longer works

This used to turn off filtering, for small images. I think.

Only fetch contributor data during build

Currently, a fetch request happens upon navigating to a page which is unnecessary because the contributors data cannot change independently from the page.

Move logic to config.js file instead

Vue Notification System

Create a system for notifications to give users feedback (e.g. successfully copying code snippet)

Drop-down CSS (tailwind?)

Current drop-down doesn't look amazing. Can we properly implement tailwind classes, to make it match Bedrock.dev?

Write 404 resolver for redirecting links

This can wait until 1.1, since we will be doing a giant reorganization of the content, after the platform is complete.

Make dark theme more visually pleasing

The dark theme seems a bit to contrasty and could do with more matching to the jekyll wiki's dark theme

Create better styling for light-theme code-blocks

Currently, they share a theme:

Close all other sections when one section is opened

Prevents this kind of issue, where the sidebar is just completely overwhelming.

Backmerge wiki edits from last 2 months.

After splitting, pages have been edited, and new pages added.

Most likely needs to be done by hand, although it won't be too much work because there wasn't that many commits, I think.

Create "copy code" button for code-blocks

This can wait till 1.1:

Sidebar generation broken

Since the "index.md" files have been removed from each category, the generateSidebar() function is no longer pushing categories without this file to the sidebar data.

Spacing for Contributors widget

Create MoLang snippets page with MoLang Grapher integration

Source for functions

Ideally, it should be a component, that takes in a MoLang expression and renders a graph of this expression with expression being syntax highlighted.

Hide pages from nav/sidebar, using front-matter

I don't know if this feature already exists, but it would be very helpful for us in the future!

Mobile Support: Dynamic scaling for <H> tags

We need some kind of dynamic scaling, since right now we are getting very large headers. Images for comparison.