Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
  • Nov 30 21:57
    joskfg commented #4686
  • Nov 30 21:21

    github-actions[bot] on gh-pages

    Deployed 5ad86f55f with MkDocs … (compare)

  • Nov 30 21:21
    squidfunk labeled #4686
  • Nov 30 21:21
    squidfunk labeled #4686
  • Nov 30 21:21
    squidfunk unlabeled #4686
  • Nov 30 21:21
    squidfunk closed #4686
  • Nov 30 21:20
    squidfunk commented #4686
  • Nov 30 21:20

    squidfunk on master

    Added support for binding funct… Merge branch 'master' of github… (compare)

  • Nov 30 20:56

    github-actions[bot] on gh-pages

    Deployed c7a779f5b with MkDocs … (compare)

  • Nov 30 20:56
    squidfunk closed #4690
  • Nov 30 20:56
    squidfunk commented #4690
  • Nov 30 20:55

    squidfunk on master

    Fix: Update schema json for lin… Merge pull request #4691 from j… (compare)

  • Nov 30 20:55
    squidfunk closed #4691
  • Nov 30 18:16
    squidfunk closed #4697
  • Nov 30 18:16
    squidfunk commented #4697
  • Nov 30 17:45
    alelom edited #4697
  • Nov 30 17:43
    alelom edited #4697
  • Nov 30 17:43
    alelom opened #4697
  • Nov 30 13:11

    github-actions[bot] on gh-pages

    Deployed 907705a51 with MkDocs … (compare)

  • Nov 30 13:10

    squidfunk on master

    Updated changelog (compare)

facelessuser
@facelessuser:matrix.org
[m]
Well, this is far from a minimal example, and I don't have access to the bitbucket branch, but what I'll say from what I can see in your project is that if you are running from the Documentation folder, you will have to use a base_path setting that is relative to add the User folder to your path ../User. If you need access to both User and Documentation, you may have to use a relative path of .. and then reference your snippets via User/README.md and Documentation/README.md. The point is basically that you need to add the folder(s) to your base_path setting to get access to them. If you add multiple base_path locations that have files of the same name, it will use the first found, so be careful with your approach.
4 replies
facelessuser
@facelessuser:matrix.org
[m]
I am the author of the Snippets package, and it should be able to work with relative paths. Had I been able to run the example you provided, I probably could have helped much more. A minimal reproducible example (only what is needed to reproduce the issue) usually helps such questions move along much faster. Unfortunately, I was not able to run your example as there were other things in the example that prevented me.
Martin Donath
@squidfunk
@facelessuser:matrix.org what's the progress on #4268? The issue has been pinned for 3 months now, does it still need input/awareness? Can we unpin it?
facelessuser
@facelessuser:matrix.org
[m]
Unfortunately, I still don't think there's been nearly the input from the community as I hoped, but that is fine. I'm pushing to get an alpha out for the feature over the long holiday weekend. I have to finish updating unittests and write up some documentation. But functionality wise, I think it may be there. Some general life stuff got in the way, but I think we will be able to get it into people's hands very soon.
Personally, it would be nice to have awareness through the pre-release time, but it is up to you as to how long you'd like to pin the issue in Material.
Martin Donath
@squidfunk
Okay, thanks for the heads up. I'll close this issue now, and invite you to create a new issue when the alpha is out, ideally with some usage examples. I'll pin it again. If there's a use case that already works, we can also add it to the documentation to get more exposure (PR appreciated). That should hopefully raise some awareness. It's sad that not much feedback was received, but my experience is that authors will give feedback once they start using it. I guess during the pre-alpha stage, extension developers are more likely to give feedback than authors.
Also, many thanks for your work on this. I'll investigate the new capabilities once the alpha is out to build new components for Material for MkDocs.
facelessuser
@facelessuser:matrix.org
[m]
The biggest thing I was hoping to get resolution on was syntax stuff. I was less concerned about API stuff at this point. Unfortunately, with the very small amount of participation, no clear consensus for the syntax directions could really be made, so we are just pushing ahead with what we have. There isn't an overwhelming slant towards either side with most of the things. During the alpha period, I will at least make clear the big points I'm hoping to get feedback on and we'll see if we get more conversation moving forward.
Martin Donath
@squidfunk
Sounds good.
You will definitely get complaints on the syntax. No matter what you decide on.
You know how it is 😅
facelessuser
@facelessuser:matrix.org
[m]
Oh, I know 🙃
miked
@mikedeischle
Is there a way to add custom buttons next to the search / darkmode (button)?
Martin Donath
@squidfunk
Yes, you can override the header.html partial and add your buttons to the template. See our customization guide for how this can be done.
miked
@mikedeischle
I mean without creatig my own header. AFAIK you need to rewrite it if you use the overrides
Martin Donath
@squidfunk
You need to use partials, yes. You can copy the partial and add your markup.
Making this configurable would introduce too much complexity, as use cases for buttons are very different. Some only want that a button points to a link, another user might want a button that adds functionality.
zeren
@zeren:matrix.org
[m]

I am not sure if there is a issue im doing wrong but I cant seem to get the RSS to work properly with the blog plugin.

When I run the link via a RSS Validator and I get an error for the author name:

line 1, column 433: Invalid email address: zeren [help]

... Hello again world!</title> <author>zeren</author> <category>Bar</categor ...

and also description error like this:

line 1, column 676: Missing channel element: description [help]
... n 2022 00:00:00 +0000</pubDate> </item> </channel></rss>
Martin Donath
@squidfunk
It looks like an error in the generated RSS. It's a good idea to ask the maintainers of the RSS plugin.
... and consult their documentation: https://guts.github.io/mkdocs-rss-plugin/
zeren
@zeren:matrix.org
[m]
Gotcha, will do thanks!
Timo Toups
@lampensau
hehe, like the flakes @squidfunk. will this feature "stick" or will it "vanish" like snow does usually around my area? :P
pawamoy
@pawamoy:matrix.org
[m]
❄️
Timo Toups
@lampensau
:snowflake:
pawamoy
@pawamoy:matrix.org
[m]
(this emoji triggers flake snowing on element/matrix hehehe)
Martin Donath
@squidfunk
It'll eventually be removed, likely after Christmas 😊 It's just a temporary thing. I've made sure that removing it doesn't break any builds.
Rosson Long
@z3thon_twitter

So I am pretty much done designing the layout for my Material with MkDocs documentation site but I have one final speedbump.
I would like to organize my content without having to make sure it's alphabetical or that I'm using number at the beginning of each thing.

I currently have the following working:

nav:
   - Menu Header 1: <location>
   - Menu Header 2: <location>
   - Menu Header 3: <location>

I am trying to get the sub drop-downs of each page and then the .md files inside each one organized in a custom ordering without using numbers and alphabetization.
Is there any way to achieve this? I have seen it done in other places but I can't seem to figure out the right formatting and I've looked through the docs to try and understand the formatting but can't find anything that show's what you do beyond the first level of menu headers.

This is an example of what I have tried to do in my mkdocs.yml to try and create the experience I want with .md files being out of order alphabetically.

nav:
   - Menu Header 1: <location>
      - Welcome.md
      - Our Team.md
   - Menu Header 2: <location>
      - Forging a Path.md
      - Apples Start Jouneys.md
   - Menu Header 3: <location>
      - Table Guide: <location>
         - The Rule Book.md
         - Showing your hand.md
      - Create your Character: <location>
         - Face.md
         - Eyes.md
         - Nose.md
         - Hair.md
"Face, Eyes, Nose, and Hair" are not in alphabetical order here and they are inside of a "menu header 3" and then in the "Create your Character" drop-down.
When I run the code with my mkdocs.yml file like this it breaks and can't compile.
Martin Donath
@squidfunk
I'd start by evaluating the mkdocs-awesome-pages-plugin
Rosson Long
@z3thon_twitter
I'm pretty sure it's just a syntax problem but I can't find any examples of how it's supposed to be.
Martin Donath
@squidfunk
Rosson Long
@z3thon_twitter
Oh! Is this level of manipulation not possible using the basic "nav" part of the mkdocs.yml file?
Martin Donath
@squidfunk
No, YAML does not allow that.
But it's trivial to set up, see the page I just sent you.
Rosson Long
@z3thon_twitter
Screen Shot 2022-12-01 at 3.53.24 PM.png
They're doing it here, Tabs at the top out of alphabetical order and then drop downs with markdown files also out of alphabetical order.
Martin Donath
@squidfunk
I don't know where that's from or what's used.
Check out the plugin I linked above
Otherwise, creating a discussion on our discussion board might be a good idea, so other users can help you.
I have seen several problems and solutions in my time maintaining the project, but obviously not all 😁
Rosson Long
@z3thon_twitter
K. Looking through the resources you sent me.
In this example they are just using a hyphen followed by a name and the colon.
Then immediately afterwards they list pages and locations.
Does this only work if tabs are turned off? Or if everything is only a single layer deep?
nav:
  - Section:
    - section/index.md
    - Page 1: section/page-1.md
    ...
    - Page n: section/page-n.md
Rosson Long
@z3thon_twitter
Basically without mkdocs-awesome-pages-plugin you can't have more than 1 layer deep with the default .yml nav: settings.
Rosson Long
@z3thon_twitter
Screen Shot 2022-12-01 at 4.29.24 PM.png
Martin Donath
@squidfunk
Please create a discussion.
Rosson Long
@z3thon_twitter
How do I start a discussion?
Martin Donath
@squidfunk
It's very hard to follow your example/screenshots in the chat here.
Then click "New discussion".