gordstephen / pdsite Goto Github PK

Like mkdocs

Useful if you include pdsite --help option and this informs us about available commands.

Hi there, I love the project and how simple it is.

One article I read recently talks about the importance of making sure that websites are designed to last. One main point of failure is referencing external javascript and css stylesheets. Perhaps it might be worth having a simplified stylesheet as a fall back if the external ones fail.

I think most people that look at this project will be fairly technical and so interested in this option. Effectively I think if they choose to not use bootstrap there should be a bare bones fall back.

Specifically I think you should have an extra case in this section of template.html where neither bootstrap or bootswatch is specified:

$if(bootswatch)$
  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootswatch/3.3.6/$bootswatch$/bootstrap.min.css">
$else$
  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css">
$endif$

I do love bootswatch as well and I have done some work on creating a bare-bones bootstrap style CSS that you could use as a fallback. My rather crudely named mofoforms experiment (based on BMFW) might be enough for most pages on your site. Possibly not the navbar, but that should be easy enough to extend for.

This is the complete CSS that I use:

      body {
        color: #444;
        font-size: 18px;
        margin: 40px auto;
        max-width: 720px;
        line-height: 1.4;
        font-family: sans-serif;
        padding: 10px 16px;
      }
      h1,h2,h3 {
        line-height: 1.2
      }
      a {
        text-decoration: none;
      }
      h1,h2,h3,h4,h5,h6 {
        font-weight: normal;
      }
      table {
        border-spacing: 0;
        border-collapse: collapse;
      }
      th, td {
        border-top: 1px solid #444;
        padding: 10px 16px;
      }
      input, textarea, select, button {
        font-family: sans-serif;
        font-size: 18px;
        color: #666;
        padding: 10px 2%;
        line-height: 1.4;
      }
      label, button {
        margin-top: 10px;
      }
      label {
        display: block;
      }
      fieldset {
        padding: 10px 16px;
        border: none;
      }
      input, textarea {
        width: 96%;
      }
      select {
        width: 100%;
      }
      label input {
        width: auto;
      }

For example It's-raining.md file causes error

https://github.com/hoijui/pdsite/

As this project seems dormant, I suggest using my fork for now, until there is word from @GordStephen .

I already made a lot of changes, about half of them fixes. Some of these fix issues present in this repository.

Hi!

The example does not work.

It just puts the plain contents of the "tmp-local-tree-yaml" at the end of the page.
So no navigation tree is built by the template.

I made some "fixes" to have at least the yaml correctly parsed to get some data into the contents variable of the template.
However, wasn't enough... no idea what makes it go south...

I expect, that this is caused by some unexpected behavior by one of the dependencies...

Some version info (besides the rest of my up-to-date manjaro):

[hans@Rechenknecht docs]$ pandoc --version
pandoc 2.17.1.1
Compiled with pandoc-types 1.22.2, texmath 0.12.5, skylighting 0.12.3,
citeproc 0.6.0.1, ipynb 0.2
User data directory: /home/hans/.pandoc
Copyright (C) 2006-2022 John MacFarlane. Web:  https://pandoc.org
This is free software; see the source for copying conditions. There is no
warranty, not even for merchantability or fitness for a particular purpose.
[hans@Rechenknecht docs]$ tree --version
tree v2.0.2 (c) 1996 - 2022 by Steve Baker, Thomas Moore, Francesc Rocher, Florian Sesser, Kyosuke Tokoro 
[hans@Rechenknecht docs]$ bash --version
GNU bash, Version 5.1.16(1)-release (x86_64-pc-linux-gnu)
Copyright (C) 2020 Free Software Foundation, Inc.
Lizenz GPLv3+: GNU GPL Version 3 oder jünger <http://gnu.org/licenses/gpl.html>'''

What license is this code under?

I want to make it work on the BSD's via standard POSIX shell, instead of the unsafe bash that it is now.

I get

$ pdsite build
Clearing old build folder... done.
Building site...pandoc: Could not parse YAML header: did not find expected key "source" (line 46, column 22)
pandoc: Could not parse YAML header: did not find expected key "source" (line 3, column 19)
 done.
[xan@argonia prova]$