projectpages / project-pages Goto Github PK

Documentation on how to add issues to a forked version of project-pages needs to be created and added to the README document.

Blog View

Content

• Normal Content View
• Image View
• Link Snippet View
• Presentation View
• Deep Linking

Github Tools

What links back to Github do we need?

1. Link to repo
2. Link to raw file
3. Edit the file
4. Link to User with Gravatar

Other

• Pagination
• Comment notfications
• Readability View
• Share

Anything else?

Exposed in Blog Roll View

• thumbnail
• tagline
• title
• author
• gravatar
• tags

Can we add a page that has a picture and bio about each collaborator? The bio would include specific skills that each person can bring to the table. This may help with adding more collaborations from outside parties.

Ross and Krishna

Settle on a way for users to deploy project-pages without forking.

Provide process to remove image zoom on hover if user does not want it, or enable it as an option to toggle on and off.

Create functionality that allows users to easily create interactive plots in posts.

Can you make tags more flexible so that

1. each post may have multiple tags,
2. tags are arbitrary text keywords rather than images from a predefined list (methods / results)?

See, for example, Notepad theme (demo, repo), which has text tags, categories and their indexes.

Would require calling of the GitHub API on build, may require setting up another server.

Documentation on how to add collaborators to a repository as well as giving collaborators the right to push to the repository needs to be created and added to the README file.

The very last slide on the side layout is broken the link currently points to url/Project-Pages instead of url/project-pages.

See if it can be linked directly form the repository to allow modularity for later development.

Add a collection _api that allows the site pages, posts, and data to be accessed.

Otherwise implement a self hosted RSS and comments tracker that would effectively do the same job.

How do you indent text lines in markdown?

Krishna and Ross

How can we specify picture dimensions on the website?

When we create figures, what pixel count should I make them with so that they do not appear blurry?

Ross and Krishna

The comment feature for my website created using project pages is not working

• Make a subset visible not only posts.
• See if the "add link from blog" button can be automated for every deployment.
• Update metadata fields for new layouts after they are implemented.

Some functionality breaks when the repository name is changed.

The picture shows up on this link:
https://github.com/RossVerploegh/Hybrid-ZIF-Structure-Elucidation/blob/gh-pages/_posts/2015-02-27-EMMCZ-RJV.markdown

The picture does not appear here:
http://rossverploegh.github.io/Hybrid-ZIF-Structure-Elucidation/2015/02/27/EMMCZ-RJV/

Is it possible to add query tags to each post that specify whether its a post about Methods or Results?

Maybe this would best to have two separate pages for each? We can discuss this further about the best way to proceed.

Ross

This repository will host a Jekyll site to act as a scientific research blog.

Import Features

• gh-pages is main branch
• _config.yml is the only file that needs to be modified
• instructions to run local server
• the demo site is run off of another repository

Questions

• Does master host anything?

Can we find a way to include either interactive pictures or animations in the website?

Obviously there is a space limitation to this but I am sure using this functionality a couple times on the website can be really useful.

Ross

All non-Jekyll compilation modifications are with javascript.

• The {{site.data}} will be passed to javascript through in the _template/*.html
• All blog posts will have an *.html extension and will markdownify the content automatically and manually turn off. This allows for pagination.
• Host javascript and style sheets through jsdelivr, otherwise cloning is expensive.

Table formating not supported on project pages

In research-pages we used a few tools like fullpage.js and mathjax to make a presentation mode and show equations respectively.

Initial Thoughts

• Plain/formatted text interpreter (e.g. Markdown)

• Latex support (MathJax)

• Presentation Support (Reveal.js)

• Discussions (Disqus - this requires good documentation*)

• Some interactive visualization ( baked in d3, d3 gallery, Plotly, raw.densitydesign )

• Notebook support

  could be a recognized file type.

• External API support ( embedly is good hack to start)

How can we change the font colors on all the website pages (titles, posts, etc.)?

Ross

Content based on whether main, page or post.

Can we add a search bar to the home page that would direct someone to specific posts?

Ross