Livemark is a static page generator that extends Markdown with interactive charts, tables, and more.

Related tags

Markdown/YAMLlivemark
Overview

Livermark

Build Coverage Registry Codebase Support

This software is in the early stages and is not well-tested

Livemark is a static site generator that extends Markdown with interactive charts, tables, scripts, and more.

Purpose

  • Improved writing experience: Now your Markdown data articles can include interactive charts, tables, a live development server, and much more.
  • Static site generator: Livemark only operates with static files - it creates an HTML file from your Mardown file.

Features

  • Open Source (MIT)
  • Full Markdown compatibility
  • Markdown extensions such as tables and charts
  • Straight-forward command-line interface
  • Live development server

Example

Take a look at the DEMO article

# Build a single document (index.md by default)
$ livemark build

# Start a livereload server
$ livemark start

Documentation

Please visit our documentation portal:

Comments
  • URL Problems using `livemark build` on Windows

    URL Problems using `livemark build` on Windows

    Overview

    I'm trying to build a simple livemark static site with a colleague and we're experiencing a very interesting problem due to operational systems differences, I believe.

    I'm using Linux ubuntu 20.04 and he's using Windows 10.

    When I run livemark start or livemark build on my ubuntu everything goes well, but when he does the same on windows it builds weird URLs. It appears that "/" is been changing to "%5C", as you can see here.

    The Github source code could be found here.

    I also tried to run livemark build --help and see if there were some options related to windows construction and also to search for something in the documentation.

    bug 
    opened by gabrielbdornas 5
  • build / start not working

    build / start not working

    Hi @roll! I am going through the docs and am getting errors when trying to build / start the site.

    First, I created a new project without an index.md and got errors, and I also tried it after creating an index.md file and got the same errors. Here are the errors:

    livemark build: 'str' object has no attribute 'setdefault'

    I also tried livemark start & got an error: AttributeError: 'str' object has no attribute 'copy'

    Then, I tried building the site from this repo and also got errors.

    livemark build: to_snap() got an unexpected keyword argument 'json'

    and

    livemark start: TypeError: to_snap() got an unexpected keyword argument 'json'

    I'm on Python 3.8 & Livemark 0.39.0

    Any ideas? Thanks!

    bug 
    opened by lwinfree 4
  • Doc: Starting project fails

    Doc: Starting project fails "No documents to build in the project"

    The page: https://github.com/frictionlessdata/livemark/blob/main/pages/getting-started/starting-project.md

    gives instructions to start a project but it fails with:

    $ livemark start
    No documents to build in the project
    

    Obvious reason is, that the file livemark.yaml is incomplete:

    brand:
      text: My Project
    site:
      favicon: assets/favicon.ico
    

    as it does not contain any pages section so there is nothing to build.

    documentation 
    opened by vlcinsky 2
  • aways use posix paths on generated relative paths in html

    aways use posix paths on generated relative paths in html

    • fixes #205

    With livemark is used in Windows, outside a POSIX compliant system the generated URLs inside the generated HTML will have Window back slashes (\folder\file instead of /folder/file). This happens because of how gel_relapath is generating the path using os.path.join. os.path always follows the format of the current OS, this means, if you are in windows it is going to use back slashes. The problem happens that urls follow POSIX path, with this slash /.

    I don't know if there are other places that we need to change the paths to POSIX ones. If we just change everywhere that os.path is used, this will causes problems for windows user when livemark need to open a file somewhere.

    bug 
    opened by aivuk 2
  • Install error

    Install error

    Overview

    Hi @roll , first of all: this is great idea, a great product, thank you very much 🙏🙏🙏.

    When I install it, I have this error:

    ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
    mkdocs-rss-plugin 0.17.0 requires Jinja2<3,>=2, but you have jinja2 3.0.2 which is incompatible.
    jinja-markdown 1.200630 requires Jinja2~=2.11, but you have jinja2 3.0.2 which is incompatible.
    datapackage-pipelines 2.2.6 requires python-dateutil<2.8.1, but you have python-dateutil 2.8.1 which is incompatible.
    

    Does the only solution is to use virtualenv?

    Thank you

    Please preserve this line to notify @roll (lead of this repository)

    opened by aborruso 2
  • `pip install` downloads all versions

    `pip install` downloads all versions

    Installing with the recommended approach (pip install livemark) or a fresh virtual environment with pip, setuptools, and wheel up to date currently takes a long time, as the frictionless requirement is set with a star: https://github.com/frictionlessdata/livemark/blob/cd4200f143dfe6d77874de23e8c13a1cbeea0e08/setup.py#L48

    Due to requirement settings in dependencies, it means that pip also downloads multiple versions of other libraries (livemark itself, simpleeval, etc.). In a non-fresh environment (e.g. one in which frictionless is already installed) it might lead to conflicts during installation, but I was not able to immediately reproduce it (maybe it depends on the order the packages are installed). The multiple downloads were reproduced both under the latest stable Ubuntu (with Python3.8) and WSL.

    bug 
    opened by tresoldi 2
  • Test different basepath scenarios

    Test different basepath scenarios

    Overview

    Currently, it works fine on localhost and https://livemark.frictionlessdata.io/ but there might be basepath problems e.g. on GIthub Pages without a custom domain.

    bug duplicate 
    opened by roll 2
  • Finish the documentation

    Finish the documentation

    Overview

    It needs to be finished for version 1

    Plan

    • [ ] structure: logic, table, chart, script, markup, sidebars, widgets, config, plugins?
    • [ ] improve current articles
    • [ ] add new articles
    • [ ] update the main (demo) page
    • [ ] update the readme (features)
    enhancement 
    opened by roll 2
  • quick edit

    quick edit

    I quickly read thru all the pages & fixed typos/grammar.

    I can merge this @roll but I'll wait until tomorrow in case you have time & want to look first.

    The documentation is looking really nice!!

    opened by lwinfree 1
  • Rebase default template on using Github Templates

    Rebase default template on using Github Templates

    Overview

    We have a Github Template for Livemark project - https://github.com/frictionlessdata/livemark-project. We need to use it instead of livemark/assets/documents/template.md to avoid duplication.

    duplicate enhancement 
    opened by roll 1
  • Consider supporting slow scripts within build/start

    Consider supporting slow scripts within build/start

    Overview

    Currently, even though with caching it's not a good idea to have long-running scripts in the script snippet because every livemark build/start; it will be fully executed (although cached during the start session).

    ATM we need to write separate scripts to fetch the data and we can include it to the site using FilePlugin. We might consider some special options like slow tags/etc to include these scripts to Livemark makrdown. It's something to investigate.

    enhancement 
    opened by roll 1
  • Add collapsed/hidden plugin

    Add collapsed/hidden plugin

    Overview

    It's really popular feature for the writing engines - an ability to have some sections hidden by default with an ability to expand by a reader

    feature 
    opened by roll 0
Releases(v0.110.1)
Owner
Frictionless Data
Lightweight specifications and software to shorten the path from data to insight. Code of Conduct: https://frictionlessdata.io/code-of-conduct/
Frictionless Data
A minimal platform for Markdown-based blogs

madblog This project provides a minimal blogging platform based on Markdown files. Demos This project powers the following blogs: Platypush My persona

Fabio Manganiello 2 Aug 02, 2022
Markdown Presentations for Tech Conferences, Training, Developer Advocates, and Educators.

March 1, 2021: Service on gitpitch.com has been shutdown permanently. GitPitch 4.0 Docs Twitter About Watch the Introducing GitPitch 4.0 Video Visit t

David Russell 5.4k Jan 05, 2023
A Python implementation of John Gruber’s Markdown with Extension support.

Python-Markdown This is a Python implementation of John Gruber's Markdown. It is almost completely compliant with the reference implementation, though

Python-Markdown 3.1k Dec 31, 2022
Comprehensive Markdown plugin built for Django

Django MarkdownX Django MarkdownX is a comprehensive Markdown plugin built for Django, the renowned high-level Python web framework, with flexibility,

neutronX 740 Jan 08, 2023
😸Awsome markdown readme for your profile or your portfolio

GitHub Profile Readme Description That's a simple and minimalist README.md for your profile Usage You can download or copy to your repository and make

0 Jul 24, 2022
Awesome Django Markdown Editor, supported for Bootstrap & Semantic-UI

martor Martor is a Markdown Editor plugin for Django, supported for Bootstrap & Semantic-UI. Features Live Preview Integrated with Ace Editor Supporte

659 Jan 04, 2023
A Straightforward Markdown Journal

Introducing Pepys: A straightforward markdown journal "It is rightly made for those who love to document their daily life events" - FOSSBytes Pepys is

Luke Briggs 23 Nov 12, 2022
A markdown lexer and parser which gives the programmer atomic control over markdown parsing to html.

A markdown lexer and parser which gives the programmer atomic control over markdown parsing to html.

stonepresto 4 Aug 13, 2022
A Python library to retrieve annotations and notes from Zotero and save them into Markdown files.

Zotero to Markdown Generate Markdown files from Zotero annotations and notes. With new Zotero PDF Reader, all highlights are saved in the Zotero datab

Essi Alizadeh 20 Nov 03, 2022
An automated scanning, enumeration, and note taking tool for pentesters

EV1L J3ST3R An automated scanning, enumeration, and note taking tool Created by S1n1st3r Meant to help easily go through Hack The Box machine and TryH

14 Oct 02, 2022
A markdown generation library for Python.

Welcome to SnakeMD SnakeMD is your ticket to generating Markdown in Python. To prove it to you, we've generated this entire README using SnakeMD. See

The Renegade Coder 22 Dec 08, 2022
Notedown - Markdown <=> IPython Notebook

Python 2/3 and IPython 4 / Jupyter compatible! Convert IPython Notebooks to markdown (and back) notedown is a simple tool to create IPython notebooks

Aaron O'Leary 840 Jan 04, 2023
Rich-cli is a command line toolbox for fancy output in the terminal

Rich CLI Rich-cli is a command line toolbox for fancy output in the terminal, built with Rich. Rich-cli can syntax highlight a large number of file ty

Textualize 2.5k Jan 02, 2023
Yuque2md - Offline download the markdown file and image from yuque

yuque2md 按照语雀知识库里的目录,导出语雀知识库中所有的markdown文档,并离线图片到本地 使用 安装 Python3.x clone 项目 下载依

JiaJianHuang 4 Oct 30, 2022
Mdut: a tool for generating Markdown URL tags

mdut mdut (pronounced "em-doot") is a tool for generating Markdown URL tags. It

Nik Kantar 2 Feb 17, 2022
Markdown journal template.

Markdown Journal Template Description This project contains a script which creates a markdown journal template for the current year by creating a mark

Stephen McAleese 2 Mar 06, 2022
Lightweight Markdown dialect for Python desktop apps

Litemark is a lightweight Markdown dialect originally created to be the markup language for the Codegame Platform project. When you run litemark from the command line interface without any arguments,

10 Apr 23, 2022
An interactive, terminal-based markdown presenter

lookatme lookatme is an interactive, extensible, terminal-based markdown presentation tool. TOC TOC Features Tour Navigating the Presentation CLI Opti

James Johnson 1.4k Jan 01, 2023
A automated python script that creates mark-down files to read for the aes keys and other useful information.

Archive A automated python script that creates mark-down files to read for the aes keys and other useful information. Table of Contents Benbot Automat

Tector 13 Dec 14, 2022
A markdown template manager for writing API docs in python.

DocsGen-py A markdown template manager for writing API docs in python. Contents Usage API Reference Usage You can install the latest commit of this re

Ethan Evans 1 May 10, 2022