pRoJEct-NeGYa

pRoJEct-NeGYa is a hacker-styled Jekyll theme for building content-oriented blogs, CVs, and learning notes, with per-collection organization and extensive front-matter customization.

What is pRoJEct-NeGYa?

pRoJEct-NeGYa is a Jekyll theme that runs on Ruby with Bundler and converts Markdown articles into a static website with a terminal-like aesthetic. It takes content stored in collection folders and renders it into a navigable site with an archive page, table of contents, and Atom feeds. The theme is maintained by DeerRIDER and distributed under the MIT License on GitHub.

Key Features

pRoJEct-NeGYa offers a set of content-focused features covering math, code, security, and layout control.

• Highly customizable front matter — each post or page accepts toggles for table of contents depth, comment areas, footer visibility, home buttons, encryption, and publication status.
• Formula insertion with MathJax — write LaTeX-style math in Markdown and render it on the page for technical notes.
• Online code testing — code blocks can be run directly in the browser, supporting review and experimentation.
• Code highlighting — built-in syntax highlighting makes source code readable in the hacker theme.
• Text decryption — using SJCL, you can encrypt parts of a page and reveal them when the visitor supplies the correct key.
• Table of contents — optional auto-generated TOC with configurable depth from level 1 to 6.
• Comment system via Disqus — connect your Disqus account in _config.yml to enable comments.
• Mermaid diagram support — render flowcharts and diagrams from Mermaid syntax in your notes.
• Atom feeds and SEO — includes jekyll-feed and jekyll-seo-tag plugins for syndication and search visibility.

Who is it for?

pRoJEct-NeGYa targets individuals who want a distinctive, code-centric presentation for written content.

• Students and researchers — keep lecture notes and technical articles organized in separate collections with formula support.
• Developers — build a personal website or CV with code samples that readers can execute online and highlight.
• Writers — maintain a content-oriented blog with editable navigation, category-based post lists, and a clean reading layout.

What can you do with pRoJEct-NeGYa?

With its collections and front-matter options, you can adapt pRoJEct-NeGYa for several distinct publication types.

• Organize notes by collection — create separate folders for notes, portfolio, or album entries and register them in _config.yml to get distinct permalink structures.
• Publish an encrypted snippet — enable encrypted_text in front matter so a portion of the page stays hidden until a key is entered.
• Create a CV-style portfolio — use the portfolio collection and manually order posts to present projects in a specific sequence.
• Run a blog with comments — enable Disqus and category-based post lists to turn the theme into a full blog.

How does pRoJEct-NeGYa work?

Setting up pRoJEct-NeGYa involves cloning the repository, editing configuration, and writing Markdown collections.

1. Fork the repository on GitHub and clone it locally.
2. Edit _config.yml with your site title, Disqus username, and collection settings.
3. Write Markdown files inside collection folders, adding front matter variables for layout, TOC, encryption, and visibility.
4. Run bundle exec jekyll serve to preview the site at 127.0.0.1:4000, and then push to GitHub Pages for public hosting.

Pricing

pRoJEct-NeGYa is free and open source under the MIT license, so you can use, modify, and redistribute it without payment.

FAQ

Here are answers to common questions about pRoJEct-NeGYa.

Is pRoJEct-NeGYa free?

Yes, the theme is licensed under the MIT License, which permits personal and commercial use with attribution.

What do I need to run pRoJEct-NeGYa?

You need RubyGems, Bundler, and Jekyll installed on your machine. The prerequisites cover macOS, Ubuntu, and Arch Linux package managers.

How do I add comments to my site?

Create a Disqus account and enter your username in the disqus_username field inside _config.yml. Then set comment: true in the front matter of the pages where you want the comment area to appear.

Can I hide a page from the public?

Use the publish front matter variable. Setting it to false keeps the page invisible on the live site while it remains in your repository.