معرفی شرکت ها
cliriculum-0.2.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A python cli tool to rapidly create an html or PDF resume
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | cliriculum-0.2.1 |
| نام | cliriculum |
| نسخه کتابخانه | 0.2.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | - |
| ایمیل نویسنده | - |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/cliriculum/ |
| مجوز | MIT License Copyright (c) 2022 Alexandre Sonderegger Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
# cliriculum
[](https://github.com/sondalex/cliriculum/actions/workflows/run-test.yaml)
[](https://github.com/sondalex/cliriculum/actions/workflows/doc-build.yaml)
[](https://github.com/sondalex/cliriculum/blob/master/LICENSE.md)
[](https://pypi.org/project/cliriculum/)
Create your CV/Resume with a simple Python CLI tool.
## Installation
```console
pip install cliriculum
```
## Web Dependencies
* [fontawesome](https://fontawesome.com/)
* [pagedjs](https://pagedjs.org/)
Both are bundled in the package.
## Structure
<img src="https://raw.githubusercontent.com/sondalex/cliriculum/master/example/output.png" width=200/>
* Main: The right part of the page(s). Place where generally experiences, past jobs, past studies, ... are displayed.
The content gets generated from Markdown file `--main=<your Markdown file>`
* Sidebar: Place for brief description of your skills, your contact details etc.
The sidebar is split in two parts:
1) `contact`: gets generated from JSON file: `--contact=<your JSON file for contact details>`
2) `description`: gets generated from markdown file `--description=<your description.md>`
Sidebar supports one page only, however the colour is continued to next pages.
Additional metadata:
* dates.json: A JSON file with keys matching titles ids defining a start and end information. During rendering the dates are added to the top of the paragraph of the level two headings with matching id.
Heading ids are parsed uniquely for level two headings. Dates should be under the
[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
Markdown files are parsed with [github.com/miyuchina/mistletoe](https://github.com/miyuchina/mistletoe).
Metadata is added to Abstract Syntax tree representation before rendering to HTML.
## JSON SPEC
Refer to documentation at `cliriculum.deserializers` to better understand
the implicit JSON structure, specially classes `Contact` and `Dates`.
## Viewing
To view the HTML page a local server is necessary.
Indeed, modern web browsers disallow
loading CSS and js scripts from `file:///*`.
An error of the form `Cross-Origin Request blocked` is raised
for each file loading attempt.
A well-used turnaround is to use cdns or/and use
inline css. See sphinx documentation for example.
Currently, I chose not to use this method.
## Rendering
* Export to HTML
* Export to PDF (via browser or headless mode)
## Cli
```
cliriculum --main="main.md" --description="sidebar.md" --contact="contact.json" --dates="dates.json"
```
## Converting to PDF
Open with the generated HTML with your web browser
(Chromium based browsers recommended).
Run `ctrl+p` or `cmd+p` and print to PDF.
The HTML representation of the document relies
on [paged.js](https://pagedjs.org/) a great library
intended to create PDF compatible HTML books.
Note: the content has to be distributed by a local server. See [Viewing](##Viewing) for why.
Python solution:
```console
# suppose you saved resume in resume directory (`cliriculum --destination=resume`)
cd resume/
python -m http.server --bind 127.0.0.1
```
Or set `--pdf-output` flag.
```console
cliriculum --main="main.md" --description="sidebar.md" --contact="contact.json" --dates="dates.json" --pdf-output=output.pdf
```
## Styling
You can modify style by modifying the generated `style.css` file. However, each time
you overwrite the resume, the modified style.css gets back to default.
To encounter this behaviour you can specify a secondary stylesheet.
```console
cliriculum --main="main.md" --description="sidebar.md" --contact="contact.json" --dates="dates.json" --stylesheet="custom.css"
```
## Example
An example can be viewed at [example/index.html](https://sondalex.github.io/cliriculum/_static/example/index.html)
## Language support
English only.
## Warning
No XSS injection prevention.
Make sure to adopt good security practices if you wish to build a web service from
this package.
نیازمندی
| مقدار | نام |
|---|---|
| >=1.0.1 | mistletoe |
| >=0.18.1 | myst-parser |
| >=5.3.0 | sphinx |
| >=2.0.1 | sphinx-autoapi |
| >=2022.12.7 | furo |
| >=0.17.1 | myst-nb |
| - | pdf2image |
| >=7.2.1 | pytest |
| >=3.3.0 | pypdf |
| >=2.28.2 | requests |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.9 | Python |
نحوه نصب
نصب پکیج whl cliriculum-0.2.1:
pip install cliriculum-0.2.1.whl
نصب پکیج tar.gz cliriculum-0.2.1:
pip install cliriculum-0.2.1.tar.gz