Bug 1088607

Summary: python-pelican should (probably) require python-markdown
Product: [Fedora] Fedora Reporter: Ben Rosser <rosser.bjr>
Component: python-pelicanAssignee: Nobody's working on this, feel free to take it <nobody>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 20CC: marcelo.barbosa, mrunge, rosser.bjr
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: python-pelican-3.3.0-4.fc20 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-05-09 03:07:10 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Ben Rosser 2014-04-16 21:08:50 UTC
Description of problem:

pelican is a static site generator that takes input from REST or Markdown files; however, markdown is considered an optional dependency. The official Pelican documentation (http://docs.getpelican.com/en/3.1.1/getting_started.html) notes that python-markdown needs to be manually installed alongside Pelican if you want to enable Markdown support.

The Fedora package does not Require python-markdown, though, so if you just install the package through yum without reading the quickstart guide, you won't get python-markdown and so pelican won't actually be capable of doing anything with Markdown files.

I ran into this when working on a website that I had started on a different computer. I was working from the Pelican quickstart guide the first time and so didn't run into an issue, but the second time I simply ran "yum install python-pelican", hoping it'd pull in all dependencies. I was then briefly confused when I looked at the build output until I checked the quickstart guide again and noticed I hadn't installed python-markdown.

Personally, I think the package should just require python-markdown, even though markdown is technically an optional dependency.


Version-Release number of selected component (if applicable): 
3.3.0-3.fc20 


How reproducible:
Always.


Steps to Reproduce:
1. Install python-pelican
2. Do not install (or remove) python-markdown
3. Create a new pelican project using pelican-quickstart and create some *.md files in content/
4. Attempt to build using "make html".


Actual results:

"make html" returns the following output:

[bjr@rannoch pelican-test]$ make html
pelican /home/bjr/Programming/python/pelican-test/content -o /home/bjr/Programming/python/pelican-test/output -s /home/bjr/Programming/python/pelican-test/pelicanconf.py 
WARNING: No valid files found in content.
Done: Processed 0 articles and 0 pages in 0.09 seconds.

If you then run "make serve" (the command to launch a debugging server on port 8000), you will, as probably expected, see a webpage devoid of any content.


Expected results:

You wouldn't see that warning, and running "make serve" would show you all your content.

Comment 1 Jamie Nguyen 2014-04-21 14:51:35 UTC
Thanks for your bug report.

I agree that python-markdown should be pulled in as a dependency. Package updates to follow..

Comment 2 Fedora Update System 2014-04-21 15:07:39 UTC
python-pelican-3.3.0-4.fc20 has been submitted as an update for Fedora 20.
https://admin.fedoraproject.org/updates/python-pelican-3.3.0-4.fc20

Comment 3 Fedora Update System 2014-04-22 04:01:28 UTC
Package python-pelican-3.3.0-4.fc20:
* should fix your issue,
* was pushed to the Fedora 20 testing repository,
* should be available at your local mirror within two days.
Update it with:
# su -c 'yum update --enablerepo=updates-testing python-pelican-3.3.0-4.fc20'
as soon as you are able to.
Please go to the following url:
https://admin.fedoraproject.org/updates/FEDORA-2014-5454/python-pelican-3.3.0-4.fc20
then log in and leave karma (feedback).

Comment 4 Ben Rosser 2014-04-23 01:53:54 UTC
Awesome, the updates-testing build now requires python-markdown. I gave karma on the update.

Comment 5 Fedora Update System 2014-05-09 03:07:10 UTC
python-pelican-3.3.0-4.fc20 has been pushed to the Fedora 20 stable repository.  If problems still persist, please make note of it in this bug report.