by

Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
  • Jul 08 15:28

    daveaglick on main

    Removed the NonParallelizable a… (compare)

  • Jul 08 13:44

    daveaglick on main

    Bumping the test SDK which seem… (compare)

  • Jul 08 02:23

    daveaglick on main

    Version bump (compare)

  • Jul 08 02:21

    daveaglick on v1.0.0-alpha.21

    (compare)

  • Jul 08 02:20

    daveaglick on main

    Bumping Statiq.Framework version (compare)

  • Jul 03 13:50

    daveaglick on main

    Adds a test to verify layout me… (compare)

  • Jul 01 11:52
    CLAassistant commented #914
  • Jul 01 11:51
    CLAassistant commented #914
  • Jul 01 11:51
    Backs opened #914
  • Jun 25 16:29
    Arhell edited #913
  • Jun 25 16:24
    Arhell edited #913
  • Jun 25 16:24
    Arhell opened #913
  • Jun 25 08:34
    drmathias opened #912
  • Jun 19 00:28

    daveaglick on main

    Version bump (compare)

  • Jun 19 00:27

    daveaglick on v1.0.0-alpha.20

    (compare)

  • Jun 19 00:25

    daveaglick on main

    Added support for specifying in… (compare)

  • Jun 15 20:12
    daveaglick edited #911
  • Jun 15 20:12
    daveaglick labeled #911
  • Jun 15 20:12
    daveaglick opened #911
  • Jun 10 17:49
    daveaglick opened #910
Lee Conlin
@hades200082
That's great... thanks.
Ralph Christowiak
@Christowiak
hello together, i have a question. i wanted to generate api documentation, also with internal flagged c# classes. i don't find the possibility. can someone please give me a hint
absinghal
@absinghal
Hello @daveaglick . Want to start new documentation project(s) to host at Github Pages (/docs folder) and looking at Wyam. Understand that Statiq is the successor. Should I wait for Statiq releases and if so, how long is the expected wait. Or Should I go ahead and use Wyam - in that case will it be portable to Statiq and is it still supported. Kindly advise - Thanks.
Dave Glick
@daveaglick
@absinghal 👋 - Wyam works just fine and still powers docs for projects like Cake. That said, you're correct that Statiq is on the horizon and I'm not investing additional effort in also adding functionality to Wyam (thay're essentially the same project, just gone through a rebrand for the next version). Statiq Docs will be mostly compatible with the Wyam docs recipe, though not entirely run and forget - there will likely be a little required porting for things like settings (and more depending on how heavily the Wyam site was customized). The bigger issue for API docs is that I'm still a few months from working on Statiq Docs. If you don't need to generate actual API docs from source files or assemblies though and just need content-oriented docs, Statiq Web is very close (there's actually alphas already on NuGet) and I expect that to be usable within the next couple weeks.
absinghal
@absinghal
Thanks @daveaglick . Currently looking for content oriented docs and blogs (not looking for api docs as of now). Looking to integrate with github project based documentation(/docs folder). How to get started ?
absinghal
@absinghal
Also for one github repo, I’d like to have docs.projectname.com/blog layout for blog and docs.projectname.com/help for documentation. Is it possible thru Github pages from the same /docs folder of the repo?
John Zabroski
@jzabroski
@daveaglick Could I pick you brain on what I'm doing wrong with RazorLight?
I have more or less taken over the project from Ivan Balan and there are features people are requesting that I don't need and am not sure as to the best path forward.
My thought is we might be able to help each other.
John Zabroski
@jzabroski
Also, is Statiq ready for prime time?
I want to reboot the docs for FluentMigrator and make them prettier
John Zabroski
@jzabroski
I have to admit, I'm a bit confused why, if Statiq is the new hotness, we still chat in Wyamio/Wyam and not Statiq.
Dave Glick
@daveaglick
I keep 🤞 that GitHub turns on discussions as a wider beta soon - if you haven’t seen it, check out https://github.com/zeit/now/discussions
When that’s available I’ll probably shut this down and move all conversation there

is Statiq ready for prime time?

Whereas Wyam had a single core application and different “recipes”, Statiq has Statiq Framework and Statiq Web/Statiq Docs.

Statiq Framework just went Beta. That means I think it’s relatively stable, most obvious bugs are caught, and I’ll limit (or at least keep in mind) API breaks. Several other folks are using it production today (including me at my day job). I’d say it’s ready for prime time.

Statiq Web is being actively worked on and can be used but has a ways to go and Statiq Docs will likely start work soon.

Dave Glick
@daveaglick
What are some of the Razor feature you’re looking at? I found reverse-engineering the ASPNET Core 3.x Razor engine to be really frustrating - there’s no commitment to a public API surface and it breaks with every version as they quickly iterate on Razor Pages and Blazor.
@jzabroski ^^^ forgot to tag you in any of those, and Gitter notifications can be pretty flaky
John Zabroski
@jzabroski
People want RazorLight to support local functions and sections. I guess when I took over the project from Ivan, I somehow broke support for sections.
I kind of feel bad since Im not a Razor expert - I use it to generate email templates for an Issue Tracker system similar to Jira
Steven Kirk
@grokys
hey there. i want to host my api docs in a virtual directory at /api, but i want just api docs, as the rest of the site comes from elsewhere
i've tried doing
Settings[Keys.LinkRoot] = "/api";
Settings[DocsKeys.ApiPath] = "/";
but that causes nothing to be generated for the api
is there a way to just generate the API part?
and have /index.html be the namespace listing that would usually appear at /api?
Steven Kirk
@grokys
(this is with wyam btw, not statiq)
Mike Hingley
@computa_mike_twitter
Hi - I'm looking at using Wyam to generate a static "User manual" for an area of a site I am working on - I did something similar in NodeJS and Hugo - Is this possible? I'm writing a .net core 3 site...
Mike Hingley
@computa_mike_twitter
I've managed to set up Wyam - bit confued about setting content directories. By default Wyam will create a Content directory for me (input) but if I want to rename that I have to pass -i <new folder name> to wyam when building. Can I put that in the config.wyam file?
Danilo Silva
@daniloalsilva
Hey guys, I'm having some problems in table generation in Linux - when building a "cleanblog" with a post having tables, it works like a charm, but when building in Azure Devops pipeline, tables aren't being processed and it just shows the markdown in published page
someone already had this problem?
Stuart Lang
@slang25
Does anyone here have experience creating a GraphQL input module for Statiq? I found a great blog post here but no code: https://orcharddojo.net/blog/this-week-in-orchard-10-18-2019
Just an example of a non-trivial module would be good enough for now :)
Dave Glick
@daveaglick
Sorry all, I've apparently missed the Gitter notifications (again) - at some point I'll likely move discussions onto GitHub Discussions once that becomes available, just FYI. I've not had great luck with Gitter recently.
@slang25 I've heard some talk of folks working on GraphQL modules but haven't seen one "in the wild" yet. That said, data modules are generally pretty straight-forward - you fetch some data and create documents from it. A good similar example might be this SQL module: https://github.com/statiqdev/Statiq.Framework/blob/cdf6048822e3af54506be1d4f3e5fb5af5e25962/src/core/Statiq.Core/Modules/Metadata/ReadSql.cs - you could even consider deriving from the ReadDataModule (https://github.com/statiqdev/Statiq.Framework/blob/master/src/core/Statiq.Common/Modules/ReadDataModule.cs) if you can get the data from GraphQL into a dictionary
@daniloalsilva I haven't heard any reports of trouble with tables in alternate platforms - there was/is an issue with _ViewStart.cshtml vs. _viewstart.cshtml (the latter doesn't work on Linux), but that's a casing thing (the Razor engine is case-specific) - are you still having trouble with it? If so, go ahead and file a GitHub issue and we can start taking a closer look
Dave Glick
@daveaglick
@computa_mike_twitter Yes, you can change the input folders from the config file - you can add new ones or even change the "input" one to something different. The trick is that the config script has a global Engine property you can use which exposes a FileSystem property (which is of type IFileSystem - https://wyam.io/api/wyam.common.io/ifilesystem/). So the script should contain something like Engine.FileSystem.InputPaths.Add("other").
Steven T. Cramer
@StevenTCramer
@daveaglick Nice work mate. Time for me to move my docs and blog to Statiq . Thanks!
From docfx.
Steven T. Cramer
@StevenTCramer
docfx has [!include[Overview](Overview.md)] suggested replacement?
Mattias Karlsson
@devlead
What does it do? Could be <?! Include "./Common/Overview.md" /?> you're looking for.
Steven T. Cramer
@StevenTCramer
@devlead Yes exactly :) How did you know about that?
Mattias Karlsson
@devlead
I asked Dave last week😎
Steven T. Cramer
@StevenTCramer
@devlead BTW after my Apple IIe I had an Amiga3000 ( Amgia was pretty amazing computer)
is there an include that uses xrefs?
Mattias Karlsson
@devlead
@StevenTCramer nice, oh that would be a question for @daveaglick .
Dave Glick
@daveaglick

@StevenTCramer

is there an include that uses xrefs?

No but that's a great idea: statiqdev/Statiq.Web#908

The existing shortcodes are a big missing part of the docs - the Web specific ones are documented at https://statiq.dev/web/content-and-data/content/shortcodes but I need to do the same for the ones coming from Framework like Include
Steven T. Cramer
@StevenTCramer
It is looking great Dave, I got a good start on migrating my docs. Going to do my blog also.
Gatsby look out Statiq is in the house.
Dave Glick
@daveaglick
:)
Dave Glick
@daveaglick
@/all 🚨 Major announcement time! Statiq has been accepted into the GitHub Discussions early access program! Effective immediately all discussion should move to https://github.com/statiqdev/Discussions/discussions - I won't be monitoring the Gitter channel any longer. I'm excited to see if we can continue to grow the awesome Wyam/Statiq community in a more transparent way through the discussions platform. 🚨
Mattias Karlsson
@devlead
@daveaglick 🚀👍
Jan Karger ツ ☀
@punker76
@daveaglick 🎉👍