picocms / picocms.github.io Goto Github PK
View Code? Open in Web Editor NEWThis is the repository of Pico's official website. Pico is a stupidly simple, blazing fast, flat file CMS.
Home Page: http://picocms.org/
This is the repository of Pico's official website. Pico is a stupidly simple, blazing fast, flat file CMS.
Home Page: http://picocms.org/
Reported via IRC: https://twig.sensiolabs.org/ is offline, Twig's new home is https://twig.symfony.com/
Hi :)
I didn't know whether this or the "pico" project itself are the right place to ask this. Sorry if I'm wrong here.
Searching the website documentation of Pico, I couldn't find any information about how to resize images. Is this possible and is it documented anywhere?
Thank you very much in advance.
Provide step-by-step instructions on how to "install" plugins and themes in Pico.
plugins/
directory or upload multiple plugin files into a to-be-created directory named exactly after the pluginthemes/
directoryREADME.md
of the plugin/themeHowever: Keep it short! Users don't want to read pages over pages just to learn how to install a plugin/theme... It's dead simple. This shouldn't require much text.
GitHub recently announced a new Open Source Guides website that is
a collection of resources for individuals, communities, and companies who want to learn how to run and contribute to open source.
We might want to use these Open Source Guides for our docs to help people contributing to Pico. This needs to be evaluated though, I just skimmed through the contents.
https://github.com/blog/2318-announcing-open-source-guides
https://opensource.guide/
@PhrozenByte Not a big issue, but I was wondering if you could look into this sometime.
I've been unable to update my local picocms.github.io
repo from upstream because of a case-sensitive filename collision. My local filesystem is case sensitive (obviously, or I wouldn't be having the issue ๐), and when I try to fetch upstream, I get the following warning:
warning: the following paths have collided (e.g. case-sensitive paths
on a case-insensitive filesystem) and only one from the same
colliding group is in the working tree:
'phpDoc/pico-3.0.cache/packages/Default.html'
'phpDoc/pico-3.0.cache/packages/default.html'
'phpDoc/pico-3.0/packages/Default.html'
'phpDoc/pico-3.0/packages/default.html'
I don't know anything about your phpDocs, but I don't imagine this was done intentionally. Any attempt I make to merge upstream tries to clobber these files, keeping only one or the other. It's only been a minor inconvenience so far, but to get around it, I've been keeping my personal fork out-of-date and just editing/committing the individual files I've needed to change. ๐
Absolutely no rush on this. It's just something that I've been meaning to mention for a little while.
I just wanted to bring it to your attention because it didn't really seem like it should be set up this way.
Thanks. ๐
About this section of nginx setup recommendations.
I find that if I set it up this way, then try to open one of the forbidden places, pico offers index.php as a download instead of going to the 404 page (the 404 page works well for other non-existing pages).
Taking the example configuration as a basis, I changed it like this:
server {
listen 80;
server_name www.example.com example.com;
root /var/www/html/pico;
index index.php;
error_page 404 /404;
error_page 403 =404 /404;
location ~ ^/((config|content|vendor|composer\.(json|lock|phar))(/|$)|(.+/)?\.(?!well-known(/|$))) {
return 404;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_pass unix:/var/run/php5-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
# Let Pico know about available URL rewriting
fastcgi_param PICO_URL_REWRITING 1;
# my nginx/php-fpm combo won't work without this:
fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
}
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
}
...which gives the desired result.
It also appears safer to me, because ultimately I am giving control over these forbidden places back to nginx, and not letting pico deal with it?
I am a little unsure if this is a documentation issue or an issue with pico itself or with my setup...
If it helps, my nginx is at version 1.10.3, what is current in debian stable.
php-fpm recently upgraded from 5 to 7.
pico 2.0.4.
Greetings!
I suggest to add RSS feed under /feed/
I was able to get nginx up and running with a mix of reading https://picocms.org/in-depth/nginx/ and the helpful discussions at picocms/Pico#343 and picocms/Pico#350.
So yeah, it sort of worked. There was a weird problem, though. I opened my browser to /vendor/ to make sure the 404 worked, and it downloaded a plain-text version of index.php to my hard drive.
I was confuse. ๐
But, I managed to fix it! After some struggle, here's my new config. Would it be ok if I submit a PR to get this onto the "How to Configure Nginx for Pico" page?
Here's the fixed nginx config:
...
# 404 on the theme's README, CHANGELOG, etc.
location ~ ^/themes(/?$|/[^/]+(/?$|/[^/]+/?$)) {
error_page 404 /index.php;
return 404;
}
# 404 on PicoCMS README, CHANGELOG, and other forbiddens
location ~ ^/((CHANGELOG.md|CONTRIBUTING.md|LICENSE|README.md|plugins|config|content|vendor|composer\.(json|lock|phar))(/|$)|(.+/)?\.(?!well-known(/|$))) {
error_page 404 /index.php;
return 404;
}
# Rewrite all other requests to go to the front controller
location / {
error_page 404 /index.php;
try_files $uri $uri/ /index.php$uri =404;
}
# Front controller
location ~ ^/index\.php(/|$) {
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
if (!-f $document_root$fastcgi_script_name) {
return 404;
}
try_files $fastcgi_script_name =404;
fastcgi_param HTTP_PROXY "";
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
}
...
@PhrozenByte commented on 6 Feb 2016
This is a long-live issue to track and discuss wished updates of our website resp. documentation.
Please refer to picocms/Pico#323 for previous discussions.
_development/
collection resp. development.md
_cookbook/
collection resp. cookbook.html
portfolio
("Showcase") to re-implement customization.md
with extended information about and screenshots of all plugins and themes
_data/plugins.md
and _data/themes.md
) to make adding plugins/themes much easierphpDoc.html
and _data/phpDoc.md
as a referenceupgrade.md
or nginx.md
(picocms/Pico#343))content/
folder)<h2>
headers with a floating box in the TOC-reserved space on the left, see picocms/Pico#349 (comment) for an exampleCONTRIBUTING.md
to the "Getting Help" sectioncomposer require picocms/Pico
and provide a appropriate index.php
pico-composer
project instead? See picocms/Pico#317I want to contribute with Pico translating the site into Spanish
See #33 (comment)
Maybe we should think about how we want to manage plugins and themes in the future. Obviously I don't have enough time to actually do a code review for plugins. The idea behind this review process was to ensure a basic level of quality and to prevent malicious plugins. However, I feel like that we can't really achieve this anyway. Developers can update their plugins at any time. Furthermore there's our Wiki with yet another list of themes and plugins. So maybe we should abolish this "review required" process and switch to a much simpler process? The question is: How? I feel like the way we present plugins and themes on picocms.org right now isn't really suitable for this, is it?
Feedback is highly appreciated! โค๏ธ
I think each official plugin/theme should state explicitly the tested/compatible version of Pico for it.
e.g.:
Pagination
By: rewdy
License: The MIT License
Tested on: Pico 2.0
Something in the theme is trying to find @2x
resources when on a high DPI screen (they have @2x
appended to their name).
Apparently I've never had the Inspector Console open while browsing the website with my MacBook undocked (my desk monitors are only 1080p). With the Retina screen resolution, the scripts on the site are searching for higher res versions of all the assets, which mostly don't exist.
This amounts to a large amount of script errors, depending on the page (themes, lol).
For some reason, this is also breaking the new Javascript I wrote for the Docs. I don't know enough about Javascript to know what's going on. My guess is it's just stopping execution before it gets that far or something.
Nothing on the live site seems to break from this though, it's just a lot of 404-ing and JS console errors. It could have some consequence I'm not seeing yet though.
I don't really see us supporting High-DPI assets on the current theme (since, it needs to be replaced with a Pico solution at some point anyway). My recommendation is that I should just track down the script that's trying to replace the assets and remove it for now.
(Edit: In /style/js/scripts.js
, at the very start of the file is a section titled RETINA.JS
which seems to be our culprit.)
Thoughts?
The following pages are not easily discoverable:
Others?
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.