GithubHelp home page GithubHelp logo

gitki's Introduction

GitKi

Simple wiki using Git and Mardown

The pitch is simple

Your write your file in mardown version them with git. And then gitki take all that markdonw and generate a static site in just plain html(with some js or css).

Usage

Create a new gitki wiki.

  $ gitki create

Note : you can do it by hand it just an directory initilaized with a fresh git version

Generate the site

In your project

  $ gitki generate

This will create a site directory with your site. serve it directly with your prefered web server and voila.

Options are :

  • --from path_to_source_files : override source file path
  • --to path_to_site : generate site to another location
  • --render render_name : use another render to generate your site

List available render

  $ gitki themes

FF aka Futur Feature

Maybe they will be or not

  • more usage of thor thor can be use as main workflow to create site skeleton
  • better history
  • allow disabling history generation
  • better index
  • allow disable index generation
  • auto disbale history/index generation if files histroy/index are present src root
  • use a config file for all site generation like site.rb or somthing like that
  • add breadcrump based on folders
  • add new wiki creation
  • add a last modifed page with diff from last week for all page (and diff quantifier like +++ & --- on github)
  • basic seo rule like page title and maybe some meta keyword
  • search page based on some js
  • use scss for stylesheet and improve asset managment

Search

  • build an inverted index when generating site
  • conssume this index with javascript on the client side

Usefull links on inverted index and full text search

gitki's People

Contributors

djtal avatar

Stargazers

 avatar  avatar

Watchers

 avatar

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.