Skip to content

Conversation

alemorvan
Copy link
Contributor

@alemorvan alemorvan commented May 18, 2023

Author checklist (Completed by original Author)

  • Good fit for the Rocky Linux project? Title and Author Metatags inserted ?
  • If applicable, steps and instructions have been tested to work
  • Initial self-review to fix basic typos and grammar completed

Rocky Documentation checklist (Completed by Rocky team)

  • 1st Pass (Document is good fit for project and author checklist completed)
  • 2nd Pass (Technical Review - check for technical correctness)
  • 3rd Pass (Detailed Editorial Review and Peer Review)
  • Final approval (Final Review)

@alemorvan
Copy link
Contributor Author

warning: I added a logo needed for the cover of the book

The idea is to generate all books at each month release.
What do you think about that @NeilHanlon? Do you think it's possible?

I also would communicate about the fact one can generate the pdf he wants from our source and make its own personnalized document.

sspencerwire and others added 2 commits May 21, 2023 08:27
Co-authored-by: Serge Croisé <[email protected]>
Co-authored-by: Serge Croisé <[email protected]>
@lumarel
Copy link
Contributor

lumarel commented May 21, 2023

@alemorvan This seems to be a good case to just convert the whole thing to a Github Action, which dumps it's output in an buildartifact
plus for simplification using mkdocs's configuration inheritance feature to not duplicate half of the configuration file 🙂

And everyone who forks the repo can enable this workflow in their fork as well if they need it.
(if that sounds good I can generate you a draft how that would look)

@alemorvan
Copy link
Contributor Author

That would be amazing indeed! Thx @lumarel
I could do that on gitlab-ci, but not on github action.
I want to see what it would look like.
And indeed, whoever wants to make his own PDF would just have to fork the repository.
My original idea was to launch the CI only on new releases.

@alemorvan
Copy link
Contributor Author

@lumarel Thx for your idea.
I read the documentation about inheritance and applied it to my PR.
I also split the config files thanks to the book which is concerned and added a loop in the bash script to make it more dynamic.

I miss a solution to add a month or a version in the front page.
I will have to think about it.

@lumarel
Copy link
Contributor

lumarel commented May 24, 2023

@alemorvan There goes the time, sorry for the late reply 🙂

Okay great! Worked even better than I thought it would 😄
ah oh you want to publish it on the front page, hm don't know if there is an easy way, but as I said, Github Actions, and available in the artifacts there is easily possible, even with a schedule!

Will send you a PR on your branch soon 🙂

@github-actions
Copy link

Test results for 11b3bb1:

Number of broken URLs: 4

URL,RESULT,FILENAME
 https://packages._centreon_.com/rpm-standard/23.04/el8/_centreon_.repo,failed,books/admin_guide/13-softwares.md
 https://github.com/bdacus01,failed,guides/contribute/README.md
 https://ersei.saggis.com/,failed,guides/contribute/README.md
 http://www.flaviosiqueira.com.br/,failed,guides/contribute/README.md

@sspencerwire sspencerwire merged commit c9db13d into rocky-linux:main May 26, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants