معرفی شرکت ها

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

توضیحات

A static site generator for cmpalgorithms project

ویژگی	مقدار
سیستم عامل	-
نام فایل	cagen-0.2.0a9
نام	cagen
نسخه کتابخانه	0.2.0a9
نگهدارنده	[]
ایمیل نگهدارنده	[]
نویسنده	Xavier B.
ایمیل نویسنده	-
آدرس صفحه اصلی	-
آدرس اینترنتی	https://pypi.org/project/cagen/
مجوز	-

# cagen ## About cagen is a static site generator intented for [cmpalgorithms project](https://sr.ht/~somenxavierb/cmpalgorithms/). So it's very rare you are interested in that. Although you can use it as any other static site generator. ## License The software is distributed under [GPL 2-only license](https://www.gnu.org/licenses/old-licenses/gpl-2.0.txt). ## How it runs It assumes your documents are written with markdown syntax. It is capable of convert those documents to any other format, using [pandoc](https://pandoc.org/) (specifically [pypandoc](https://github.com/JessicaTegner/pypandoc) wrapper) and [Mako templating system](https://www.makotemplates.org/). The reason to use "external" templating system instead of built-in pandoc template system is because pandoc templates [are not capable of make conditions with values](https://pandoc.org/MANUAL.html#conditionals) (something like `$if(author=='me') Print full name here $endif$`). The program just converts markdown files to HTML ones by default in the same directory. Unlike many other static site generators, there is no predefined structure by default: no `assets` directory neither `site` directory. By default, all generated files are in the same directory than the source files. Obviously, you can modify it if you want. We provide: - a [library](https://git.sr.ht/~somenxavierb/cagen/tree/main/item/src/cagen/libcagen.py) - a command line program (called `cagen`) for convert documents - a script called `cagen-make` to generate a Makefile to convert automatically all markdown files to HTML ones. The software is implemented in [python](https://www.python.org/) because it's easy to program (I'm very language-neutral). If you want some really fast static site generator, be free to fork the project and program with any compiled language. ## Installation You can install via [pip](https://pypi.org/project/cagen/): ``` pip install cagen ``` If you are running ArchLinux or any Arch derivative ditribution, you can use this [PKGBUILD](https://git.sr.ht/~somenxavierb/cagen/tree/main/item/extras/PKGBUILD) to make a pacman package. ## Usage Basic use is: ``` cagen sourcefile.md generatedfile.html template.tmpl ``` where - `sourcefile.md` is Markdown file - `generatedfile.html` is the HTML5 file - `template.tmpl` is Mako template file See `cagen --help` for more options. This tool is some kind of low-level tool. If you want some more higher-level one to automatically converts all markdown files to corresponding HTML5 files, we provide the `cagen-make` script (see above). The steps are: ``` cagen-make --init ``` It creates `Makefile` ``` make ``` It automatically convert all markdown files to HTML5 ones using `templates/schema.tmpl` Mako template. You can modify it editing `Makefile`. ## Other resources - You can see the [issue tracker](https://todo.sr.ht/~somenxavierb/cagen-tasks) and contribute if you want suggesting new features or reporting a bug. - The [API documentation](https://somenxavierb.srht.site/cagen/) is available. - The [Mailing List](https://lists.sr.ht/~somenxavierb/cagen-list) to make a question, suggest something you want, send patches, etc. As user and developer.

نیازمندی

مقدار	نام
>=1.0.0	python-frontmatter
>=1.10	pypandoc
>=1.2.4	Mako

زبان مورد نیاز

مقدار	نام
>=3.10	Python

نحوه نصب

نصب پکیج whl cagen-0.2.0a9:

pip install cagen-0.2.0a9.whl

نصب پکیج tar.gz cagen-0.2.0a9:

pip install cagen-0.2.0a9.tar.gz