there4 / markdown-resume Goto Github PK
View Code? Open in Web Editor NEWGenerate a responsive CSS3 and HTML5 resume with Markdown, with optional PDF output.
License: MIT License
Generate a responsive CSS3 and HTML5 resume with Markdown, with optional PDF output.
License: MIT License
Thanks for the project .It is so cool.
Is there a template for adding project expericence? : )
I am an Emacs user and if you're one too, you might be wondering why all the edits you made to the css files weren't reflected.
Markdown Resume Generator takes all the css files in the template folders and concatenate them in the html file according to alphabetical order: normalize.css
-> pdf.css
-> resume.css
-> screen.css
(and other css files that you may have created in the folder).
By default, Emacs autosaves your files in the same working directory of the files you edit. These files are named exactly the same as your original file, but with a '~' at the end. These files will also go into the Markdown resume generator machinery! So if you edited resume.css, Emacs autosaves the original version of that file and this is what you have in your html: normalize.css
-> pdf.css
-> resume.css
-> resume.css~
-> screen.css
. Therefore, any changes you made in resume.css will be reversed!
You can remove the autosaved files before you generate your new html resume, but a more convenient way to deal with it is to instruct Emacs to either (1) not autosave files or (2) autosaved files in separate location. I chose the latter solution.
You can find information on how to do that and other information about auto-saving in Emacs here: Emacs Wiki: Auto Save
This is what I did in my Emacs init (.emacs) file (copied from the Emacs Wiki, but here for easy yanking):
;; Save all tempfiles in $TMPDIR/emacs$UID/
(defconst emacs-tmp-dir (format "%s%s%s/" temporary-file-directory "emacs" (user-uid)))
(setq backup-directory-alist
`((".*" . ,emacs-tmp-dir)))
(setq auto-save-file-name-transforms
`((".*" ,emacs-tmp-dir t)))
(setq auto-save-list-file-prefix
emacs-tmp-dir)
Auto-saved files are therefore saved in /tmp/emacs$UID/
Thank you @adilapapaya for helping me get started and explaining how Markdown Resume Generator works!
Hi,
Thanks for the good Resume creator.
I used it (no customization at all) on 2 different Linux installations and on the last one the <sample.pdf> created using the default "template" for PDF outputs is generated with "Arial" fonts ( ? ) and not "Times Roman" as usual in the standard short example.
Which is the way to restore or keep the default fonts ?
Is there any particular Latex configuration to respect ?
PS: Is there a way to generate HTML links as in Pandoc/markdown into the Resume?
Thanks...
I was trying to write a template that would allow the "header" portion of my resume to stay fixed at the top of the page. However, I realized that the format of the index.html doesn't really make the CSS for this very easy. However, if I could have "header", "content", and "footer" sections, then I could easily style my CSS for those specific sections.
If there is a way to do this by manipulating my Markdown in a specific way, I would love to know the solution! Thanks!
Rationale: I want to put a list of publications in the CV (important for academic people). This is currently not possible with most templates (with the exception of readable) because the CSS for lists is used to display items in line, instead of one per line.
Extra CSS (a specific ID, perhaps, like footer already does) would definitely helpon that regard.
There is no license for this project; would you mind putting it under a software license so users can know what they can do legally with the code?
The latest release has not been tagged which is why the version details are automatically updated to the previous version when the build task is run.
It seems that the links, ex: [damir.tech](https://damir.tech)
are not being generated properly.
Example: https://damir.tech/ddulic.pdf
Which is generated via docker from https://github.com/ddulic/resume
When generated locally everything is normal.
Searched through the issues but couldn't find any issue like mine.
Here is a link to the Dockerfile: https://github.com/ddulic/markdown-resume/blob/master/Dockerfile
The issue occurs in every template.
Anyone have any thoughts on where the problem might be?
Other then that the docker image and pdf are generated without a problem via docker and travis-ci.
Great work on the project!
The phar file isn't running after cloning the repository for some reason. Running this: ./bin/md2resume html examples/source/sample.md examples/output/
Results in the following error:
PHP Fatal error: Call to undefined function mb_detect_encoding() in phar:///home/abrarisme/Downloads/markdown-resume/bin/md2resume/vendor/simple- html-dom/simple-html-dom/simple_html_dom.php on line 1234
I'm pretty sure I'm doing something wrong and I'm not quite sure what that is.
I was trying to run md2resume from the project folder and set my destination folder to "/home/Work/":
md2resume html /home/Work/resume.md /home/Work/
After running the command I received an error that PHP couldn't write to folder "home/Work/". Notice the missing '/' at the beginning of the path.
It would be nice to have a custom refresh value for the reload on the tag.
e.g. md2resume html --refresh=30
$ ./bin/md2resume
The dependency '' was not found. Please run `composer install` to install dependencies.
I have run composer install
as instructed and all dependencies have been installed, but still receive the error message. This is happening in Ubuntu.
The README.md has an instuction for You may need to run './compos er.phar update'
, but there is no more composer.phar
file included. Should this just say to run composer update && composer install
?
The dd
elements can be incorrectly split across pages, sometimes even in the middle of a line.
Should this be a config var? In the markdown somehow?
It seems that the generated HTML doesn't match the HTML that you show in your example on http://there4development.com/blog/2012/12/31/markdown-resume-builder/
Are there any detailed instructions on how I can contribute a new template or feature?
Thanks for all the hard work!
While I'm using the command: watch ./bin/md2resume html --refresh examples/source/sample.md examples/output/, the terminal shows [RuntimeException] Not enough argument html [-t|--template="..."] [-r|--refresh="..."] source destination
After going through the required steps to get there4/markdown-resume
and all of its dependencies (leafo/scssphp
, symfony/event-dispatcher
) installed with composer
, I now have the ./vendor/bin/md2resume
binary available. But executing it only yields the following:
Please run
composer install
to install dependencies
However, executingcomposer install
doesn't actually install anything because everything seems to be installed:
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
Nothing to install or update
Generating autoload files
Ideas on what I might be missing or doing wrong?
If I setup dev to use md2resume_dev.php or "compile" using pake I get an exception for the modern template. I know at least blockish doesn't have this problem. I haven't changed anything in the templates folder. Maybe composer updated a package that is causing the problem. I'd really like to tweak some of the templates or create my own.
Here it the exception. I included the newlines in case that helped find the problem. Thanks!
[Exception]
parse error: failed at `Bud1
ents.l
elements.lessIlocblobF(
normalize.cssIlocblob?(??????pdf
.cssIlocblobR(??` line: 1
Is there any way to compress the size of the generated PDF output? I'm getting a file that's 1.7MB for a single file, and a few sites I've tried to upload to (Nordstrom, Dice) are rejecting it because their systems can't handle files that large.
Thanks!
Can it create a hash table of linked pages and make a bibliography or references list to add at the end of the document automatically? With [n] besides the link and everything? That'd be great for writing dissertations in Markdown and then easily converting it to pdf to print it.
Also, I said hash so there are no repeated links, but, yeah, that's pretty much what I mean.
Please respond soon as I'm writing a book on Markdown and would like to see it printed maybe before next month ends.
Just cloned and used your resume generator. I like it, although it would be nice to have a sample pdf/html resume in the repo so prospective users can get a feel for the style before deciding to clone, install software dependencies, generate a sample, etc
I already did:
composer install
Then when I do
./bin/md2resume html examples/source/sample.md examples/output/
I get:
The dependency '' was not found. Please run `composer install` to install dependencies.
on OSX
Hi, thanks for developing this powerful tool, but there is a bug when generate CV in pdf,
for example ### Experience {#experience}
, when its content are in a new page and the ### Experience {#experience}
is in the previous page, the contents are not in correct indentation.
Please remove broken link or 301 redirect to something. Broken link is http://there4development.com/markdown-resume/
Hi,
Wanted to say a huge thank you for the great project and your time answering issues. I'm having trouble editing the css of the templates - any changes I make are not reflected in the output files. Such as making an element a massive font size and then running ./bin/md2resume html --template swissen examples/source/stevevandervalk_resume.md examples/output/
produces the same file as before so obviously I am doing something wrong... Any advice would be very appreciated!
Thanks.
I tried to have composer require version ~2.0, but it couldn't find this, since the reference to this project in Packagist hasn't been updated in quite a while:
https://packagist.org/packages/there4/markdown-resume
Please update Packagist so that the 2.0.1 release, as well as the reference to dev-master are updated to point to the correct commit hashes.
Thanks!
Currently defaults to A4. Would be nice to have an optional argument for this.
Wkhtmltopdf has an argument for it:
-s, --page-size <Size> Set paper size to: A4, Letter, etc. (default A4)
Going through the source code leads me to believe the following sizes are supported:
Link on http://there4.io/2012/12/31/markdown-resume-builder/ in the sentence:
You can markup your resume with very simple headings and lists:
should be changed from
https://raw.github.com/there4/markdown-resume/master/resume/sample.md
to
https://raw.github.com/there4/markdown-resume/master/examples/source/sample.md
Hey guys,
I'm using this repo to generate my own resume and it is fantastic! What about modify the modern template and add the avatar left to the Name part?
$ composer install
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
Nothing to install or update
Generating autoload files
After command is finished, the md2resume_dev.php
file doesn't get created.
I am trying to build my resume as pdf from within a docker container. I am getting this error
QXcbConnection: Could not connect to display
Is there a workaround for this? My Dockerfile looks like this
FROM php:5-cli
VOLUME /out
ENV DEBIAN_FRONTEND noninteractive
RUN docker-php-ext-install mbstring
RUN apt-get update && apt-get -qqy install wget wkhtmltopdf
RUN wget https://github.com/there4/markdown-resume/raw/master/bin/md2resume && chmod +x md2resume
CMD ./md2resume html /out/sklose.md /out/html && ./md2resume pdf /out/sklose.md /out/pdf
The output I get is this
Wrote resume to: /out/html/sklose.html
QXcbConnection: Could not connect to display
Aborted (core dumped)
Wrote pdf resume to: /out/pdf/sklose.pdf
... it says the pdf was created, but it's actually not
After updating to v2.0.4 I noticed that when I generate my HTML file without specifying the --refresh
option, it is applying the refresh
meta tag and the refresh_rate
is set to 5.
I noticed that each of the /template/* folders have almost the exact same CSS and the exact same index.html file. Can these be moved into /templates/default and inserted into the template being used during generation?
Then each template folder would only contain the necessary CSS required to overwrite the common styling.
Thanks for the project!
I'm trying to modify the css files for my purposes, which include adding a Publications section that @lbeltrame also suggested. I also wanted to see if I can have my paragraphs start all the way to the left of the page (not after the h3 headings) so that I can also write my personal statement using the same css template.
With no experience using php and whatnot, I tried to use the CSS files directly with my .md file using pandoc. However, the output is not the same as the generator-produced one.
May I know why this is and if anyone knows, how to tinker the CSS files and test the changes effectively (I guess not having to build a release every time)?
In the header information section, i get some unexpected/undocumented behaviour.
So at first, i took the template from the example and edited some text - all was good:
Then, i removed the trailing spaces (which you can see marked underlined as green by the markdown linter i am using) and this happened:
So next, i tried adding new lines in between, which gave me too much spacing inbetween.
Also, a single trailing space does not do it, i has to be 2 or more trailing spaces. I think there is a good chance that other people might run into this issue as well, so i would suggest either:
While it is not really intuitive, option 2 seems like it is actually a feature. For example, i found that i can control the way linebreaks are handled in paragraphs of text more fine-grained because of this:
1.1 以本命盤為計算基礎。
1.2 以個星曜所在的位置計算出分數。
計算數值內容:
1.2.1各星曜之數值。
1.2.2各宮之祿、權、科、忌各數值。
1.2.3各宮職之總分。
1.3 基礎指標:以各動盤(本命、十年、流年、流月、流日)所計算出之各數值計算。
1.3.1 計算說明:各宮職無主星不借對宮主星計算;星曜及四化數值分開計算,有加權分別計算,再按比例加總。
1.3.2 指標建立(基礎指標):先要建立各指標名稱及所使用的星曜及該星曜所在之四化數值之組合,
1.3.3 應用指標建立:是由數個基礎指標所組合而成,成為新指指標。
1.3.4 各星曜數值計算方式,指標所定義之星曜,分為星曜基本數值及加權比例,每一星曜計算方式如下:
例如基礎指標名稱「表達能力」,是由巨門、天機、奏書、天梁四顆星曜所組合而成。
找出各星曜之基本數值、在何宮職、該宮之四化各數值(祿權科忌)及該宮位總分。
各星曜在此「表達能力」是佔多少比例之分配;以例為例巨門(100%)、天機(50%)、奏書(100%)、天梁(50%),比例是可以調整。各星曜計算完成,再乘上權重。若上述星曜是在宮職在「命宮」預設值為130%、「遷移宮」預設值為120%、「財帛宮」或「官祿宮」預設值為110%
例巨門星在財帛宮基礎數值為5*100%(星曜分配比例)*110%(財帛加權)星曜總分為5.5
1.3.5 四化數值計算,指標所定義之星曜所在的宮位四化數值列出。
四化計算是各星曜在各宮之四化數值做計算,各四化都有獨自加權計算。
以上例巨門星為例,巨門星在財帛宮,四化數值(祿28.3100%+權0100%+科1100%+忌-5100%)*100%(星曜分配比例)=24.3
1.3.6 星與四化數值分配比例(需可調)。
預設值為星曜佔50%、四化佔50%。
以上述例子星曜總分為5.550%+四化總分24.350%=14.9
1.3.7 宮位總分計算。
除上述之計算以外,以宮職總分*40%(星曜、四化分配比例)。
1.3.8 指標總分計算。
由上述數個星曜及四化分數加總,加上宮位總分計算,為指標總分。
計算樣如 Excel 檔案所示。
2.1 建立應用指標:應用指標是以數個基礎指標加以組合,分例分配成為新應用指標。
2.1.1 計算說明:先定義新指標名稱,將基礎指標依例計算加總。
2.1.2 混合計算:基礎指標+基本星曜、四化、宮職計算。
3.1 建立指標名稱:可以分別新增、修改、刪除各指標內容及計算方式。
3.1.1 數值比較:可以複製完整數值備份使用,可以同時比較三種不同設定數值差異。
3.1.2 指標輸出:可以選擇部份數值顯示或比較。
3.2 基礎指標運算。(各項指標完成定義後,再執行,內部研究用)
3.2.1 指標完成定義,要全部計算一次,時間從民國13年(甲子年)農曆一月一日子時開始,每一個時辰計算一組指標,到民七十二年(癸亥年)農曆十二月三十日亥時止。合計有約262,800盤。
3.2.2 計算出各指標統計值,例如,最高值、最低值,峰值、組距、標準差、中間值等。
Hi, i have been using the project for a bit now - it has been great so far.
However, i did run it on Docker and while it was not hard to set up, i thought we could ease the installation process by prebuilding an image. Would you be willing to link the repo with Docker Hub and build an easy-to-use image?
I can help you with setting that up and also have a Dockerfile ready which we can use. Let me know if you are interested.
Please see the original bug at https://code.google.com/p/wkhtmltopdf/issues/detail?id=141
I try to execute: bin/md2resume pdf resume.md resume.pdf
, it returns:
PHP Fatal error: Class 'Phar' not found in /home/acgtyrant/bin/md2resume on line 10
So what's wrong? Thank you!
Instead of forcing the output filename to match the source file appended with ".html", why not allow for a custom output file?
e.g. md2resume html resume.md index.html
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.