nairobilug / pelican-alchemy Goto Github PK

Hello, I would like to receive commit access to nairobilug/pelican-alchemy.

There seems to be very little maintainer activity on this repo, and I assume that is because people with access are busy with other important things in their lives. The theme you've created is one of a few good themes for Pelican and is the only one I've found that is based on Bootstrap 4. I think it deserves to be supported better and promoted a lot more than it is now.

I am a hobbyist Python developer from St. Petersburg, Russia. I'm also a longtime Linux user. You can judge my skills by the following projects:

• Attila is another theme for Pelican. I've contributed quite a few pull requests and issues there.
• musicbatch and hods are my pet projects written in Python. You can check them to evaluate the quality of my code.
• bash-complete-partial-path and LibPQ are the projects of mine that got relatively popular. Check them to see how I handle collaborators, issues and pull requests.

Currently I'm building a Pelican extension for somewhat unusual type of content. It's not published yet, but when I'll reach the minimum viable product I'll make the GitHub repository public under a copyleft license. I use Alchemy as the base theme for this project, all custom templates are meant to be provided by extension itself and/or via THEME_TEMPLATES_OVERRIDES in pelicanconf.py

While I was using Alchemy I've noticed several points where it may be improved. I've already proposed the most important changes in pull requests (#79, #80). Those are the most drastic changes that require community feedback before implementing, but there are also many minor fixes that can and should be done - and if I'll have access I'll fix them upon encountering.

I value the clean look and feel Alchemy provides and I would never want to change that. Another valued feature of Alchemy for me is requiring no Javascript in default setup - I wouldn't change that too. I intend to focus on making the theme more general purpose (using configurable menu items, getting rid of hardcoded values, making use of Jinja2 macros for repetitive sections) while maintaing the same looks and fixing any occasional bugs I encounter along the way. If I'll have enough spare time I'd like to look into open issues and pull requests - quite a few of them are rather old, users must be tired of waiting.

I understand that I am a new person and you have little reason to trust me with your project. I can assure you I won't do anything destructive on purpose and I have enough experience with git to avoid doing anything destructive by accident. But there is more than the assurances from a stranger: GitHub offers multiple permission levels to allow for granular access control to the repos within organisation. A collaborator with "Write" access level is pretty much safe in regards of source code. As long as somebody else has cloned the git repo all changes introduced by a bad actor can be cleanly reverted.

Write access level also allows some community management actions (editing other people's comments, locking and transferring issues). I do not require these permissions, but as they seem to be bundled with commit access I can only say that I understand the responsibility that comes with having that access and I will not do anything to betray your trust if you give it to me.

I should also say that I accept the Code of Conduct you have and I will behave accordingly.

If you have any questions for me that may help you decide - please ask away. We can also arrange some sort of real-time conversation (e.g. on IRC), but I'd rather prefer asynchronous communication channels (this issue or e-mail).

Thank you for your attention. I'll be waiting for your decision.

Hi,
I am a beginner of pelican, and like pelican-alchemy very much. I've successfully applied pelican-alchemy for my website. However, I would like to make my current SITEIMAGE as the cover background, and make the SITENAME and links white color. Does anyone have any idea how to do that? Any suggestions are welcome. Thank you.

p.s.: I tried to SITEIMAGE = '/images/profile.jpg width=2000 height=200', but didn't work.

In the past I set up Google Analytics on my blog (the source is here) and it worked nicely. Recently, I got an update from Google that there are some updates rolling out and I should update the way Google Analytics is integrated into my pages.

In particular, I understand that the new fashion of integration is:

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXX-1"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXX-1');
</script>

and it says:

This is the Global Site Tag (gtag.js) tracking code for this property. Copy and paste this code as the first item into the of every webpage you want to track. If you already have a Global Site Tag on your page, simply add the config line from the snippet below to your existing Global Site Tag.

Currently (ref), in my blog, I have the following (coming from this Alchemy repo):

{% if GOOGLE_ANALYTICS %}
<script>
  (function(i, s, o, g, r, a, m) {
    i['GoogleAnalyticsObject'] = r;
    i[r] = i[r] || function() {
      (i[r].q = i[r].q || []).push(arguments)
    }, i[r].l = 1 * new Date();
    a = s.createElement(o);
    a.async = 1;
    a.src = g;
    m = s.getElementsByTagName(o)[0];
    m.parentNode.insertBefore(a, m)
  })(window, document, 'script', 'https://www.google-analytics.com/analytics.js', 'ga');
  ga('create', '{{ GOOGLE_ANALYTICS }}', 'auto');
  ga('send', 'pageview');
</script>
{% endif %}

If I understand correctly, this is what has to be updated. Am I right? Am I missing something? Thanks in advance for your support!

Some large images can appear out of frame and look ugly in the new default colors.
I'm not professional on css, but I think it's partly because of the incomplete fluidbox design?
And before it lands, is there any workaround to the problem?

My idea is to simply add this or something equivalent to theme.css:

img {
    max-width: 100%;
}

Bootstrap 3.3.6 includes a handful of browser fixes:

https://github.com/twbs/bootstrap/releases/tag/v3.3.6

We are currently on 3.3.5.

Demo instance of Alchemy is pretty outdated. We need to re-render it with current version and show off new features:

• Translations
• Link blogging
• Tricky cases with FontAwesome icons

This is mostly a note to self. Help is always appreciated though :)

Updating our chemistry. Version 2.0:

• Less build dependencies
• Better fonts/typography
• HTML5 compatibility
• Simpler Jinja2 templates
• No javascript required
• Squashed bugs 🐞

pelican-alchemy ✨ was set out to work without JavaScript. But that decision has it's drawbacks. According to https://getbootstrap.com/docs/4.0/getting-started/introduction:

Many of our components require the use of JavaScript to function. Specifically, they require jQuery, Popper.js, and our own JavaScript plugins.

Curious which components explicitly require jQuery, Bootstrap's JS, and Popper.js?

• Alerts for dismissing
• Buttons for toggling states and checkbox/radio functionality
• Carousel for all slide behaviors, controls, and indicators
• Collapse for toggling visibility of content
• Dropdowns for displaying and positioning (also requires Popper.js)
• Modals for displaying, positioning, and scroll behavior
• Navbar for extending our Collapse plugin to implement responsive behavior
• Tooltips and popovers for displaying and positioning (also requires Popper.js)
• Scrollspy for scroll behavior and navigation updates

Enable people to share content beyond the boundaries of applications and websites. Example: Upcoming events can get picked up by search engines.

Ref. http://semanticweb.org/

Partly because I always have to figure it out again, but also because newbies don't stand a chance!

Hi,

I wanted to add a link to mastadon but noticed the icon wasn't rendered correctly. It seems this is because the mastadon Icon is only added in version 5.0.11 of fontawesome https://fontawesome.com/icons/mastodon?style=brands while the theme stil uses 4.7.0 from two years ago https://github.com/nairobilug/pelican-alchemy/blob/master/alchemy/static/css/font-awesome.min.css#L2
It would be nice if the fontawesome version could be updated, thanks!

Hah, fresh on the heels of #14, Bootstrap 3.3.3 has been released. 👅

Links aren't discernible in the current CSS. Links, ie... hyperlinks... you know, <a>.

The default config variable name in pelican for google analytics is GOOGLE_ANALYTICS, but in this theme, using of this variable doesn't add google analytics ID to the generated HTML. Instead, one has to use GOOGLE_ANALYTICS_ID. To a person migrating from a different theme to this theme, it is confounding. This is because he/she will expect the existing GOOGLE_ANALYTICS word to be working, but later he finds out (often after a few days) that this word is not correct!

The current release structure is becoming unsustainable. As more people adopt, and reference pelican-alchemy, tracking master is laying the foundations for "wtf moments".

A solution is to start tagging releases. Maybe using a simple scheme like semantic versioning etc.

hello, I'm from china and here's something that is not very beautiful.

In a code block, chinese may display somewhat wrong.

Besides, i love the theme. It's a pretty great theme. I'll do some workaround later.

Looks good, let's clean this up and get it merged. Right now the profile image isn't displaying.

Chances are that a user has loaded jQuery or Bootstrap from cdnjs (for example) already, so this would save us re-fetching two js files again for nothing. See:

• https://cdnjs.com/libraries/jquery
• https://cdnjs.com/libraries/twitter-bootstrap

Otherwise, pretty official jQuery CDN is: https://code.jquery.com/

And the official jQuery CDN supports HTTPS and SPDY 3.1, so that's yay!

If I specify a summary in the markdown page of a blog article, like so

Summary: This is a short summary of the page

then, on the first page of the blog, it should show this summary, instead of initial few lines of the blog article. I'm not well-versed with how pelican works, so I'll wait till someone fixes this. I'll be grateful if somebody does this, and improves this theme. It's a theme I'm actively interested in, and am about to switch to this theme for my personal blog

A few things:

• Adjust headings so that the largest heading is an H1 (##)
• Clean up code snippets
• Add a better screenshot, from a Mac ideally ;)
• Add build instructions for re-generating style.css

Looking at the code it seems like maybe if FEED_ATOM or FEED_RSS are set it should appear, but those are set by Pelican by default, so I'm confused.

Love the theme though! Great stuff, it totally de-uglified my blog! :)

Hello, I'm using your template: very nice!

I've faced a little problem: my pages didn't appear as a menu item. I've fixed with little editing of "templates/base.html" file:

• Line 71 & 85: removed "and PAGES"
• Line 77: "PAGES" changed in "pages"
  Now it works!

I'm new to github and I've thinked that a pull request for this little issue was a bit overkill, then I wrote my solution here for review.

Was just released a few days ago. Lots of changes, probably the biggest release so far of the Alphas. Check the Alpha 6 ship list and release blog post for an idea of what got changed / removed.

Hi Everyone;

I'm a fresh sprout with Pelican and Jinga, and wins some battle with bootstrap

but when I try to insert a dropdown menu in the header, as they show here
it always result as a non clickable hamburger :(

Somebody succeed to insert a dropdown menu ?
if yes how did you do ?

Regards!

Jonathan

Dear Nairobilug

I just want to say thank you, then pelican-alchemy is just great !

• proper programming
• proper description
• super design

If interested you can find my application here, which I have expanded a little bit. And if interested I can send you my expanded static files.

Best greetings, Peter

Related to nairobilug/nairobilug.or.ke#75

Hello, it a beautiful template, and I love it.

There is a little bug about site image.

https://panhaoyu.github.iohttps://raw.githubusercontent.com/panhaoyu/images1/master/icons/site.jpg

I think you know what has happened. The site image use the reletive url.

I believe that a absolute url is better, for the image may not be at the same origin of the site. And I can create the url in a programming way.

Hallo ,

sorry that i post my question here,but i don't know where to ask a question..
I have saw your wonderful work of “alchemy” pelican theme.
And I want to use your theme as a model to build up my own blog.
But I have some problems to set up the theme of yours.
Could you please give me some supports if you have time, thank you very much !
My blog is http://d-yu.github.io/
As you can see, the profile image cannot show up, as well as the menu items.
I thought it might be the problem of my pelicanconf.py(in attach) configurations. I have created a images folder under the folder C:\Users\Yu\Dropbox\Blog\Pelican-themes\alchemy\static\images. And put the profile image.gif(200 pix *200 pix) in it.

I am a beginner of python and Html.. I only know a little about c language but I desire to have my own blog.
Thanks a lot for your help.
default

Regards,
dong

No CSS rules for table tags
When creating tables in Markdown, the generated HTML files has no defined style to display the table fields/tags.

Using pelican-alchemy:

Using an in-line css:

Bootstrap 3.3.x has a few new releases. We are on 3.3.0.

http://blog.getbootstrap.com/2015/01/19/bootstrap-3-3-2-released/

Bootstrap 3.3.x has a few new releases. We are on 3.3.0.

http://blog.getbootstrap.com/2015/03/16/bootstrap-3-3-4-released/

Can you please merge #74? It is not possible to publish with Pelican 4.x otherwise.

Latest Bootstrap is 3.2.0, but we're on 3.1.1: http://getbootstrap.com/