search for: mkdocs

Hi, Lei and I have been working on the project, based on community input. We have implemented two way sync between github and pagure as suggest by many. Now we want build the site and display it to user. There are number of options mkdocs, hugo(docker uses it now) etc. There are pros and cons to each site generator. To use hugo, we need the user to have hugo installed too, and than he needs to run hugo command to create a new file, which is big con. Mkdocs is great too, but little inflexible we found. Any suggestions on which too...

...naal jain <kunaalus at gmail.com> wrote: > Lei and I have been working on the project, based on community input. We > have implemented two way sync between github and pagure as suggest by many. > > Now we want build the site and display it to user. There are number of > options mkdocs, hugo(docker uses it now) etc. > > There are pros and cons to each site generator. To use hugo, we need the > user to have hugo installed too, and than he needs to run hugo command to > create a new file, which is big con. > > Mkdocs is great too, but little inflexible we found....

...constraint is that the site generator should require minimal human effort, as we plan to build the site continuously through CI, so the new content should automatically be indexed, added to navigation panels, content directory etc. Coming to existing site generators, we looked at Jekyll, Hugo and Mkdocs. Hugo - very flexible, great tool but complicated. User needs hugo installed to contribute. Docker uses this, switching from mkdocs. Mkdocs - Not very flexible, but very friendly. User needs to create doc in mardown, add the link in another file and done! Jekyll -- very blog specific, which we d...

Hello folks, I spend some time today mucking about trying to figure out how to make our documentation search a better experience. The short answer is, search kind of works now. Long answer: mkdocs creates a client side file which is used for search. RTD overrides this by referring people to Elasticsearch. However, that doesn't clear out stale entries and we're plagued with a whole lot of stale entries. I've made some changes that other consumers of RTD have done to override our s...

...Infra== 1. A backend server listing to Github and Pagure webhooks and mirroring content. 2. A http site displaying the temporary docs. 3. A pagure instance ==Testing == 1. Fork the https://github.com/kunaaljain/test-centos-docs 2. Add new content to docs folder in mardown language. 3. Update the mkdocs.yml file and add the new file you just created with appropriate heading. 4. Create a pull request. 5. Within 15-20 seconds, a comment will be made on pull request, with the pagure link, which displaying various metadata. 6. Once the staff approves, PR is merged and site updated at http://clown-olga...

...was selected ~10y > ago for its simplicity and online editing, but in 2017, most people (dev > and ops) are probably using other workflows, like git/pull-requests/etc. > > So what about exploring other possibilities ? > > I don't have a real proposal (even if mkdocs.org <http://mkdocs.org> > , simple solution with > Markdown, combined with git would be perfect for me) but just wanted to > start a dedicated thread so that we can think about the future of > wiki.centos.org <http://wiki.centos.org> > > Opinions ?...

...to a mailing list ( with a different account BTW ), announce their intention and request real access, wait for access. > Git-based doc is probably something more formalized and for tech writers > having to maintain an "official" doc. > I (in the past) had a look athttp://www.mkdocs.org/ for this (and so > all the .md can be in a public git repo that people can submit PR to) > While personally I don't mind switching to something using git in the > workflow, I'm wondering if such tool shouldn't be used instead to target > "official" docs under...

...be still use a wiki or something else ? Moin was selected ~10y ago for its simplicity and online editing, but in 2017, most people (dev and ops) are probably using other workflows, like git/pull-requests/etc. So what about exploring other possibilities ? I don't have a real proposal (even if mkdocs.org , simple solution with Markdown, combined with git would be perfect for me) but just wanted to start a dedicated thread so that we can think about the future of wiki.centos.org Opinions ? Proposals ? anything else ? Fee free to comment :-) -- Fabian Arrotin The CentOS Project | https://www....

On Mon, Apr 11, 2016 at 10:37 AM, Karsten Wade <kwade at redhat.com> wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > On 04/11/2016 09:18 AM, Jim Perrin wrote: >> What are the thoughts or concerns about this sort of workflow >> change? > > Any chance Moin Moin can store wiki source in git and sync > automatically with a central git repository?

Hi I have just installed a lot of updates on a CentOS 4 box and w appears to have stopped working -- this machine has 3 or 4 people connected via ssh, yet this is all that is outputted: # w 20:46:32 up 301 days, 3:21, 0 users, load average: 0.02, 0.03, 0.04 USER TTY FROM LOGIN@ IDLE JCPU PCPU WHAT "rpmverify procps" returns nothing so the package

...o Github and Pagure webhooks and mirroring content. > 2. A http site displaying the temporary docs. > 3. A pagure instance > > ==Testing == > > 1. Fork the https://github.com/kunaaljain/test-centos-docs > 2. Add new content to docs folder in mardown language. > 3. Update the mkdocs.yml file and add the new file you just created > with appropriate heading. > 4. Create a pull request. > 5. Within 15-20 seconds, a comment will be made on pull request, with > the pagure link, which displaying various metadata. > 6. Once the staff approves, PR is merged and site upd...

...is no longer an option. > > Akemi That's what I fear too. A wiki is something that has to be edited live, and be quick/fast. Git-based doc is probably something more formalized and for tech writers having to maintain an "official" doc. I (in the past) had a look at http://www.mkdocs.org/ for this (and so all the .md can be in a public git repo that people can submit PR to) While personally I don't mind switching to something using git in the workflow, I'm wondering if such tool shouldn't be used instead to target "official" docs under centos.org/docs and...

...thing else ? Moin was selected ~10y > ago for its simplicity and online editing, but in 2017, most people (dev > and ops) are probably using other workflows, like git/pull-requests/etc. > > So what about exploring other possibilities ? > > I don't have a real proposal (even if mkdocs.org , simple solution with > Markdown, combined with git would be perfect for me) but just wanted to > start a dedicated thread so that we can think about the future of > wiki.centos.org > > Opinions ? Proposals ? anything else ? Fee free to comment :-) ?I personally would like to...

Hi Got a box that acts as a web/db server - recently i have started to see odd timeout errors between the app and webserver on this box - Can't see anything obvious and as far as i'm aware nothing has changed any ideas? 9:27am up 128 days, 21:12, 1 user, load average: 4.05, 3.45, 3.07 Mem: 1027760K av, 1022644K used, 5116K free, 196K shrd, 141620K buff Swap: 2097112K

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 05/30/2015 09:19 AM, Dougal Matthews wrote: > An alternative approach would be to build the docs in CI and link > to the built version in a comment on both systems. This is an interesting idea. We'll end up wanting docs to build in the CI anyway, so this could be done using e.g. a -draft tag so an initial commit can be used to both build

...thing else ? Moin was selected ~10y > ago for its simplicity and online editing, but in 2017, most people (dev > and ops) are probably using other workflows, like git/pull-requests/etc. > > So what about exploring other possibilities ? > > I don't have a real proposal (even if mkdocs.org , simple solution with > Markdown, combined with git would be perfect for me) but just wanted to > start a dedicated thread so that we can think about the future of > wiki.centos.org > > Opinions ? Proposals ? anything else ? Fee free to comment :-) > > > -- > Fabian...

how can i stop root logging into ssh ? I presume there is a setup file somewhere? thanks

Hi all! Anyone tried to install vmware on a xen system (ie. vmware player on dom0?). David _______________________________________________ Xen-users mailing list Xen-users@lists.xensource.com http://lists.xensource.com/xen-users

...ithub to git.c.o <yangl1996> yes <kunaaljain> once sync is done, Then new site has to be generated and deployed. <yangl1996> we can use open source tools to do this <kunaaljain> Yes that sounds easy. <yangl1996> Mkdocs <yangl1996> we can use that <kunaaljain> ;) Then upstream projects <yangl1996> :) yes <yangl1996> we use pull model <kunaaljain> here a REST API? <yangl1996> sounds good! <kunaaljain...

Hi list, I have trouble install the following perl modules to my Centos 4.2 server and I need help Digest::SHA1 Digest::HMAC Net::DNS Time::HiRes HTML::Tagset HTML::Parser Pod::Usage Parse::Syslog Statistics::Distributions I tried "perl -MCPAN -e shell" and then "install Pod::Usage" and I got the following errors: CPAN: Storable loaded ok Going to read /root/.cpan/Metadata