https://github.com/robert-zacchigna/robert-zacchigna.github.io
Personal site of data science related projects ranging from data analysis and exploration to machine learning and prediction models (mostly using Jupyter Notebook).
https://github.com/robert-zacchigna/robert-zacchigna.github.io
data-science jekyll jekyll-site jupyter jupyter-notebook machine-learning python
Last synced: 2 months ago
JSON representation
Personal site of data science related projects ranging from data analysis and exploration to machine learning and prediction models (mostly using Jupyter Notebook).
- Host: GitHub
- URL: https://github.com/robert-zacchigna/robert-zacchigna.github.io
- Owner: Robert-Zacchigna
- License: other
- Created: 2021-11-29T17:42:40.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-10T04:02:38.000Z (3 months ago)
- Last Synced: 2025-04-10T05:20:30.810Z (3 months ago)
- Topics: data-science, jekyll, jekyll-site, jupyter, jupyter-notebook, machine-learning, python
- Language: HTML
- Homepage: https://robert-zacchigna.github.io
- Size: 114 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# BlackDocPlus (GitHub Page)
View Site Here: [Project Portfolio](https://robert-zacchigna.github.io)
View Demo: https://robert-zacchigna.github.io/BlackDocPlus/
BlackDocPlus is a two-column [Jekyll](http://jekyllrb.com) theme that's ideal for websites that require a master-detail layout for viewing of content. It's based on [Poole](http://getpoole.com), the Jekyll butler, and the [Hyde](http://hyde.getpoole.com) theme.
## Contents
- [Features](#features)
- [Quick Start](#quick-start)
- [Usage](#usage)
- [Options](#options)
- [Sidebar menu](#sidebar-menu)
- [Scrolling sidebar content](#scrolling-sidebar-content)
- [Themes](#themes)
- [Reverse layout](#reverse-layout)
- [Development](#development)
- [Author](#author)
- [License](#license)
## Features
* Now compatible with Jekyll 3.x
* Two-column layout with scrolling sidebar content
* Ideal for websites that require master-detail view of content
## Quick Start
Download the zip file or clone the BlackDoc repo.
```bash
git clone [email protected]:Robert-Zacchigna/BlackDocPlus.git mysite
cd mysite
```
Make sure you have Ruby 3.1.2 or higher installed.
```bash
ruby --version
ruby 3.2.1
```
Install bundler and install dependencies.
```bash
gem install bundler
gem install jekyll bundler
bundle install
bundle update --bundler
```
Build and run your BlackDoc site.
```bash
bundle exec jekyll serve
```
> **NOTE:** This theme is designed to specifically run using GitHub Pages and thus will not run correctly when run locally, to run this site locally use the [BlackDocPlus-Local branch](https://github.com/Robert-Zacchigna/BlackDocPlus/tree/local)
## Usage
BlackDoc is a theme built on top of [Poole](https://github.com/poole/poole), which provides a fully furnished Jekyll setup—just download and start the Jekyll server. See [the Poole usage guidelines](https://github.com/poole/poole#usage) for how to install and use Jekyll.
## Options
BlackDoc includes some customizable options, typically applied via classes on the `` element.
### Sidebar menu
Create a list of nav links in the sidebar by assigning each Jekyll page the correct layout in the page's [front-matter](http://jekyllrb.com/docs/frontmatter/).
```
---
layout: page
title: About
---
```
**Why require a specific layout?** Jekyll will return *all* pages, including the `atom.xml`, and with an alphabetical sort order. To ensure the first link is *Home*, we exclude the `index.html` page from this list by specifying the `page` layout.
### Scrolling sidebar content
By default, BlackDoc includes a scrolling sidebar that will display your markdown files in alphabetical order.
### Themes
BlackDoc ships with eight optional themes based on the [base16 color scheme](https://github.com/chriskempson/base16). Apply a theme to change the color scheme (mostly applies to sidebar and links).
To use a theme, add anyone of the available theme classes to the `` element in the `default.html` layout, like so:
```html
...
```
To create your own theme, look to the Themes section of [included CSS file](https://github.com/karloespiritu/blackdoc/blob/master/public/css/blackdoc.css). Copy any existing theme (they're only a few lines of CSS), rename it, and change the provided colors.
### Reverse layout
BlackDoc's page orientation can be reversed with a single class.
```html
...
```
## Original Theme Author
**Karlo Espiritu**
-
-
## Theme Modification By
**Robert Zacchigna**
-
## License
Open sourced under the [MIT license](LICENSE.md).