Giter VIP home page Giter VIP logo

brick-website's People

Contributors

dependabot[bot] avatar ektrah avatar epaulson avatar ezrichards avatar gtfierro avatar jbkoh avatar shreyasnagare avatar wcrd avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

brick-website's Issues

Disordered Apps layout

Apps layout in the Category template gets disordered when the category count is less than three.

upgrade gridsome (and a few things to fix)

In order to build the site on the mac, I had to upgrade gridsome. I used "gridsome": "^0.7.23" and "sharp": "^0.27.0" - but that broke the build on a couple of article - the new gridsome wanted a leading / on a couple of markdowns

--- a/blog/brick-and-vbis.md
+++ b/blog/brick-and-vbis.md
@@ -1,6 +1,6 @@

title: Brick and VBIS
-path: blog/brick-and-vbis
+path: /blog/brick-and-vbis
date: 2020-08-15
summary: Brick and VBIS Collaboration
tags: ['brick', 'press']

This was true of
modified: blog/brick-and-vbis.md
modified: blog/press_releases.md
modified: tools/2019-04-08-brick-studio.md
modified: tools/2019-04-08-brick-viewer.md
modified: tools/2019-04-08-query-builder.md

I can open a pull request if we want to mess around with gridsome, but if it builds for you I don't think it's pressing

Contribute

Add a page that explains how one can contribute to Brick.

Make docs more compact

Using lesser whitespace and smaller font size should make the page look more compact.

Website suggestions

Some things that jumped out to me. High-level feedback is this looks really nice!

  • Sub headers should have anchor tags so we can link directly to them (e.g. https://brick.andrew.cmu.edu/start#Learning-Materials)

  • When I click some of the headers, I get a blinking cursor (seen on Firefox). Is this intentional, or is there something funky with my browser?

  • The documentation is nice functionally, but I think its a little too squeezed in the page. Could you make it wider? Also, the breadcrumbs on top are a little large, and ends up on multiple lines. Maybe making the font smaller and/or reducing the size?

  • Stylistically, I'd prefer more spartan documentation. Something with higher contrast and fewer nested colors; Maybe a light grey/blue background and black text without a background?

  • Can we have the apps page be a list/collection rather than a grid? I'd rather see a screenshot + a short text description + link line by line rather than only a small amount of information in a grid. Some of these have ugly-looking scrollbars on the side where the picture size exceeds the size of the grid

Display issue with ontology search feature

The container holding the autocomplete suggestions when using the ontology search feature obscures the results:

image

I'm running Chrome 80.0.3987.149 (Official Build) (64-bit) on a MacBook Pro:
image

I could take a stab at this myself but wasn't sure how the interactions within the search results were intended.

Search result links don't work on gh-pages

Description
The links from search results don't work if a pathPrefix is used

To Reproduce
Steps to reproduce the behavior:

  1. In the gridsome.config.js, set pathPrefix: 'dist'.
  2. Serve the project directory.
  3. Navigate to '/dist/ontology/1.1.0' from a browser.
  4. Search for something and click on the results.

Add more tools

I came across this slide in the webinar presentation and was hoping we could add at least some of these tools/apps to brickschema.org/tools. It's not a priority right now but I think it would be really convenient for people looking for these tools.

Brick Toolchain

  1. Brick-optimized Database: HodDB
    a. An external Tool: Virtuoso
  2. Schema Viewer: BrickViewer, BrickWebsite
    a. An external Tool: Protege
  3. Brick-enabled Building OSes: BrickServer, XBOS
  4. Brick Authoring Tool: BrickStudio
  5. Metadata Normalization Tool: Plaster
  6. Open Testbed: Mortar
  7. Apps: Genie, HVACMeter, VizEnergy, XBOS

SVG logo for Brick

Hi! We would like to add Brick Schema to the LF Energy Landscape ( l.lfenergy.org ), but need a pure SVG of your logo; do you happen to have one? An EPS or AI version will also work. Thanks in advance!

Tree View for TagSets

This will be used to demonstrate the hierarchy of the current tagset and explore/look for other tagsets.

Website 403s?

After merging #98 , the Brick website is now throwing a 403 Forbidden error. @shreyasnagare can you take a look? Can't think of what would be causing this --- I don't think I touched anything that would affect this when I was on the server last week.

Brick Consortium

Add a page that gives information about the Brick Consortium.

webpage vs Vue component

This is mostly a question for @shreyasnagare (and don't worry about answering it for a while, if you're on break take some time off!)

When should something be a markdown file and when should something be a .Vue component on the site? For example,
we've got webpages/consortium.md, but we also have src/Pages/Members.vue

I probably just made webpages/consoritum.md not knowing what I was doing - should I migrate the consortium page to be a Vue thing? Or, did you just future-proof Members.vue in case we wanted to have like a members.json that Members.vue could automatically generate itself from?

pylode IRI when copying

Describe the bug
When copying the IRI of a resource the pylode IRI is copied, e.g.

http://www.linked.data.gov.au/def/pylode/brick.html#zone_air_temperature_setpoint

instead of

https://brickschema.org/ontology/1.1/classes/Zone_Air_Temperature_Setpoint/

To Reproduce
Steps to reproduce the behavior:

  1. Go to 'https://brickschema.org/ontology/1.1/classes/Zone_Air_Temperature_Setpoint/'
  2. Copy link in IRI'

Expected behavior
The copied content should be

https://brickschema.org/ontology/1.1/classes/Zone_Air_Temperature_Setpoint/

Screenshots
image

Desktop (please complete the following information):

  • OS: Win10
  • Browser: Edge
  • Version: 87.0.664.75 (64-Bit)

Version-enabled schema view

Schema search should support different versions while the default view should show the latest release version.

We can put a dropdown menu over different versions in the page.

Add a "Success Stories" or "Used By" category to the Community page

Is your content request addition to existing content? Please describe.

As more companies and organizations adopt Brick, we should highlight these companies on the page (making sure to check with them if they want to be included). This can go at the top of the page, above the initiating universities.

Describe the content you'd like

Similar to what we have now, we should have a logo that links to the homepage (or other landing page provided by the company).

Wanted to file an issue so the team was aware. I'm starting to work with a couple companies to get their information listed

Have the website re-build and re-deploy when there are commits to master

Is your feature request related to a problem? Please describe.
The website is out of date from the content in the repository. It would be nice if we had an automated process of deploying the website every time a commit is made to master. This motivates us to keep development to branches and forks, and reduces the effort in deploying the site.

Describe the solution you'd like
I'm not sure how the website is deployed now, but we can use commit hooks as the trigger for the build. Let me know if you'd like me to handle this and take over hosting of the site.

Persona

View per persona

We want to either adapt the main page according to each persona or send the user to the right page.

  • Business Leaders
    • Brick benefits
    • Brick high-level concepts
      • vs Haystack
    • Brick consortium
  • System Integrators and Building Managers (Brick UserType 1, who want to have Brick-enabled buildings )
    • Brick technical concepts
    • What to do with your building models?
      • General concepts of model conversion (from either structured one like Haystack/IFC or unstructured one like raw metadata.)
      • Introduce our tools
    • What to do with your systems?
      • Building drivers (for BACnet, existing BMSes, etc.)
      • Install Brick Server for your building.
      • How to smoothely connect
  • App Developer (Brick UserType 2, who will interact Brick only through the API for their apps)
    • Brick technical concepts
    • How to query over Brick?
      • SPARQL basic
      • SPARQL query demo over an example building
    • How to install Brick-server emulator (if any)
  • Brick Contributors
    • How to contribute?
  • Brick Consortium
    • Introduction to the consortium.
      • Membership rules
    • A link to consortium page.

Add Public Roadmap link to website

Describe the solution you'd like
We should provide a link to the public roadmap (will also be available via roadmap.brickschema.org) on the website in an easy to find location (maybe under the 'resources' page?)

Standardize the style of figures throughout the website

@gtfierro It is important to keep a consistent style throughout the website for figures.

Colors

I would like to reuse the colors we used in our Brick poster like this: https://github.com/BrickSchema/brick-website/blob/addconceptpage/webpages/images/concepts/relationships.png

The color codes are:

  • Classes
    • Location: D5E8D4
    • Equipment: F8CECC
    • Point: DAE8FC
    • Substance: FFF2CC
  • Instances: F5F5F5

Note that these are defined in the default palette at draw.io if you use it.

Fonts

For visualizing Brick graphs (instances, classes, and relationships), I would like to use Fira Mono. Each character has the same width like Courier New, but Fira Mono is wider and thicker so it's easier to read.

Let me know if you have other preferences. I'd like to learn Kierstyn's opinion on the design eventually, but it'd take more time.

Creating docs

I wanted do create the docs of yours in order to get a better understanding how BRICKS works.
I used the recommended site:
https://shreyasnagare.github.io/rdf2docs/
and choosed the Version over the drag & drop and wanted to load the docs, but nothing happend except a loading bar appears. After the loading bar is finnished nothing happends.
It is possible to get a pdf-version of your docs.

In order to bring a little bit of context to this.
My name is Tobias Rettig an I'm working at aedifion (https://www.aedifion.com/). We offer a manufacturer-neutral IoT platform for building automation and technical building equipment. Therefore we collect a lot of data and we are looking for ways to contextualize the data.
Hence I'm not the most tech guy in the world I hoped that reading your docs will help me to understand how we could implement BRICKS for our customers and don't have to read the whole RDF Documentation for example.

For direct contact
M +49 151 27255679
[email protected]

Thanks for the help!!!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.