Git Product home page Git Product logo

indigobox.github.io's Introduction

indigoBox Website Build Status

The indigoBox Website is the home of indigoBox on the web, and is developed as our front facing presecence, and a way to communicate what we do. The indigoBox website details all of our projects, explains our purpose, and gives short bios of all of our members.

The indigoBox website is hosted on GitHub Pages and is powered by simple Jekyll, HTML, CSS, and jQuery. It uses the jQuery bgswitcher plugin to handle the homepage slider.

Running the site

The indigoBox website runs off Jekyll. Per their website, you can install jekyll by running gem install jekyll, which installs the jekyll gem.

To run the website locally, clone it and in your local directory run jekyll serve. The website should then be available at localhost:4000.

Continuous Integration

The indigoBox site uses continuous integration using Travis CI. You can click the Build Status badge at the top of this README to see if tests are currently passing. To run tests locally, run the command specified for HTML Proofer in the .travis.yml file which is:

htmlproofer ./_site --assume-extension --allow-hash-href --file-ignore /old.*/

This runs HTML Proofer on the built Jekyll site, so make sure to run it after running jekyll build or while a Jekyll server through jekyll serve is running, or your test results may be out of date.

A quick explanation of the HTML Proofer commands: --assume-extension - Fix needing the .html extension on links --allow-hash-href - Fix href="#" being marked as invalid --file-ignore /old.*/ - Fix testing the site archives in /old and /old2

If you'd like to modify the testing run, find the relevant command from the HTML Proofer GitHub and update the .travis.yml file and this README.

indigobox.github.io's People

Contributors

vkoves avatar rjaltman avatar sorenspicknall avatar watercycle avatar

Watchers

James Cloos avatar  avatar  avatar  avatar

indigobox.github.io's Issues

Non-Square Contributor Images on Project Pages

This one has left me puzzled for a while, since I thought the actual attributes used in the CSS we have for these pages restricts the images to squares (though that might be incorrect), but contributors sometimes appear as ellipses and not necessarily circles on project pages. As an example, using a 1600x900 resolution in Google Chrome 55, the images appear with 68 x 76 dimensions.

This should hopefully be a quick fix, with the worst case likely marking some attributes as important.

Rename Snowshoes Images

A lot of the images used in the Project Snowshoes website have very casual names that don't explain the meaning or content (like howeven.png) these should be renamed to be more appropriate to what they are.

Project Cards show pointer cursor for non-link area

On the Projects page, the pointer cursor (the one that shows up typically if an item links to a different page or popup) shows for the entirety of a card on the projects page. However, not all of the card actually does link to the overview page. For example:

image

On the Is it fresh? card background here, even the space is given the pointer, but clicking there does nothing. This seems potentially misleading to the user.

Therefore, I was wondering if we should have this space also link, or we should remove the cursor on this area. Does anybody have particular feelings about this?

Automatically Update Copyright Date Text

Originally risen as an issue to target by @AcademyInPeril, we have to manually update each page that uses copyrights for publishing a year. An alternative approach, as suggested by @AcademyInPeril and @vkoves (informally), we can use JS to get the new date and return the year on all of those pages instead, never having to worry about this again, so as long as we place it in a footer span that applies to all of those pages.

Home Page: Carpe text shows on Snowshoes Image, and vice versa

On the home page, it seems that the timing to switch between the Carpe image and text, as well as that of Snowshoes, is not timed identically. Therefore, the text and the image slowly become more misaligned in time, leading to events where this can show up on the page:

image

(As a reference, that is the Snowshoes image showing up with the Carpe text.)

We should check that the timers for these fire at the same time, and also check for any other factors of latency that are currently unaccounted for here.

Hat tip to @greenrazer for pointing this out originally!

Move to HTTPS

GitHub now supports HTTPs, so we need to move over to it for security

Ensure Consistent Color Scheme on Project Snowshoes Site

The contributor page for Snowshoes actually does use a triadic color harmony, and it makes what is otherwise a lifeless page a little better. That said, the front page does not have its colors pleasantly matching each other as well as colors work with each other on Contribute. What are these four colors? Where were they defined? Are we trying to be the Windows flag of old, but with different colors?

It isn't terrible, but for a project that is focused around the idea of free design coming to life on the desktop, show that your design is at least decent here.

Complete the About on Project Snowshoes

I can understand a month, maybe even two, but it has been about a half a year and this page hasn't even had a mockup created for it. This is arguably the most important link on this entire page, since the copy on the front page and the setup of said page really does a horrible job at informing the visitor to what Snowshoes does here.

  • Make a mock-up for the About page that lays out full plans.
  • Actually confirm those plans are accurate.
  • Write the skeleton of the page, but do not update the page as of yet.
  • Pending approval, publish the final page.

Update Carpe Contributors

For some reason the Carpe project page only lists me and Krisztian as contributors. In reality, all current indigoBox members have made commits on Carpe, and should thus be indicated as contributors to it. See Carpe contributors graph for evidence of everyone's contribution to the project.

This is a content change consisting of basic HTML manipulation, so I have marked it as copy.

Several Pages and Some Functionality Broken on Mobile

Several pages on the indigoBox site look very broken on mobile. We need to repair this so they look usable, and then potentially consider making a different design for mobile entirely.

A list of problems (check off as completed):

  • The Projects dropdown doesn't work (it's based on a hover, which doesn't exactly happen on mobile
  • The about page looks broken, with the background cutting off halfway through the team
  • The Projects page looks broken, with project names cut off
  • The contact page looks broken, with text misaligned and mangled
  • The Carpe project page looks broken due to too many contributors

See these screenshots for reference:

Removal of Highlight on Project Pages

On the Projects landing, one has the ability to hover over images on panels to have them become lighter (so as to show that hover state). This is fine, and pretty well executed. However, the same transition is applied on the individual project pages themselves as well...but there isn't any other further interaction to be taken with the image.

Therefore, should we remove the transition on the project pages? Furthermore, should we return it to its normal brightness on said pages?

Make Projects' Contributors Section Clearer

On the indigoBox website, every project indicates who is working on the projects using circles with the profiles of the associated users, but there is no label indicating what this means. A simple label saying "Contributors", "Created By", or something of the sort would help make it clear to people unfamiliar with our site why certain people show up next to the links going off to certain projects. It might also make sense to separate the contributors into their own section entirely, especially since some projects may have a lot of contributors (like the website or Carpe).

See this screenshot for an example of how this looks right now, for reference:
screenshot from 2017-01-02 04-12-21

Mobile: Visit Site and Contributors clips off screen, forces horizontal scroll

The issue here is more with the latter problem, where most pages on the IndigoBox site have horizontal scroll disabled for mobile. On project pages, this should be no different, but the contributors list sometimes overflows on projects with many contributors (Carpe). Therefore, we need to devise a way of showing the contributors (I know that is an issue already) on mobile, but also make sure horizontal scroll is forced to be off here.

Carpe Preview Image is a Personal Account Image

The current state of the site shows off Carpe with a large screenshot on the front page, and is repeated on the individual project pages. However, the details of the image are a bit precise, as they are actually a person's schedule. Should we replace this with the generic one that is currently found on the Carpe Home Page? For quick reference, that would yield this as the new schedule (minus the orange tint):

image

Optimize Projects Page Images

If you go to the indigoBox projects page, an image is loaded for each project, and most of those images are far larger than they need to be for this page. The four images are about 2 MB in size altogether, which can be very significant, especially on a mobile device. The project tiles show up with a maximum width of 800px, so none of the project images should be larger than that for desktop, and they should probably be smaller for mobile (perhaps 400 - 500px wide).

Scrollbars appear on "Designed By" container for Project Pages

This is an incredibly small issue, and really just an aesthetic one, but there seems to be extra scrollbars coming up on the container for "Designed By" on project pages. This happens at some aspect ratios that are non-standard (e.g. not 16:9, even split screen may cause this if I recall correctly), showing up as:

image

We should probably make sure that we aren't doing anything especially restrictive with the div height, and that our conventions for avatar images for example meet proper sizing requirements appropriate for that container here.

Move to Jekyll

It would benefit, especially with the header insertion by JS (which doesn't help for SEO since projects and links would not be found by crawlers), that we use Jekyll to manage these things instead.

This was a short issue, and basically said to me by @vkoves, actually.

Contacts: IndigoBox logo populates too much of screen

On a normal view, the IndigoBox logo dominates focus on the screen, where the main text is left on the side to the right. It is actually okay in a standard desktop landscape orientation, but the logo dominance on the site becomes jarringly apparent on a split-screen view; about > 60% of space is taken by the logo alone. Also, the logo duplicates when viewing the page on mobile, showing the IndigoBox logo in the header and then the page's copy of the logo right after it. Therefore, two modifications should likely be made, per approval by discussion:

  • Edit the mobile view to remove the logo, or place the logo somewhere else.
  • Resize the div used (or adjust padding) to make sure IndigoBox logo does not take over too much space here.

Overhaul README

This was going to happen eventually. I made a talk in which I talked about how the indigoBox website README needed improving, and so we should set out to remedy it.

A few things we should have in the README:

  • Features of the site
  • Full tech stack including all plugins
  • Installation Instructions (more important after completion of issue #6)
  • Contribution Instructions (most likely saying if you have bugs or suggestions, open an issue!)

Does anyone else have ideas or suggestions for things to add to the README?

Adjust Copy on Project Snowshoes Site

I didn't even get through two sentences, and I'm already cringing at what is sadly some of the better copy that's ever been written for Snowshoes. "To prove it, we're working on a proof," is the first terrible example you'll see. We're using a dog that was used in r/photoshopbattles for our construction page.

This needs help, and a lot of it.

Snowshoes: Font Padding and CSS not displaying correctly

Right now, it seems that spacing and font resource loading for Snowshoes is not happening correctly. (A good example can be found on the very front page, or especially the incomplete About page.) Oddly enough when doing development client-side, however, all elements of the page show up properly.

Most likely, this is an issue that is caused by our recent move to Jekyll. Since it likely has no idea where to pull stylesheet resources from at the moment, since we never configured any of the Snowshoes pages for Jekyll, production shows an incorrect result compared to a local view.

Improve 404 Page

The current indigoBox 404 page is unstyled and unprofessional, and I believe is a remnant from an older state of the website. The copy should be updated to be more in line with our brand, including the title, which is currently Page Not Found :(.

For reference, here are some good examples of 404 pages:

In the most basic case, we can do something like Carpe's 404 page. It's not gorgeous, but it is good enough for the time being, and is much better than the current indigoBox 404 page.

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.