Can I make a Comment-box with reStructuredText? - comments

I have created a simple website with reStructuredText and am wondering if it is possible to create a comment-box on it.
And if it is possible how to do this, or where to find the information.
I have looked around the internet but can not find anything.

From the list of contributed extensions for Sphinx, there is the disqus extension.
If you prefer another comment system, you can use that extension as a base and modify it to create your own.

Related

How do I create the attached text annotation component where I can highlight and name a block of text in a text display box?

I was looking to use the following component:
Adding information on text blocks
I am unable to find the component that can build this. I would be super greatful if you could share how this could be done within python libraries like streamlit or some other such python based frontend libraries.
Thank you.
I did a lot of searches online but I don't know the technical name of the component and therefore I cannot find a solution online. I also tried a reverse image search on Google but can't find the name of the component.
If you are looking to use this inside of streamlit, I would recommend using the st-annotated-text library. It has the exact functionality as the image you shared. You can find additional information about the library on its GitHub page: https://github.com/tvst/st-annotated-text

Make Sphinx generate reStructuredText pages from Python docstrings

I have a free private github repo. I would like to have in a docs folder the docstrings turned into rst files.
This is what sphinx does, but generate html instead of rst.
For all rst files generated this way (let's imagine one rst file per python module), I intend to hyperlink it from the readme to have access to the code documentation this way (without having to rely on github pages, which I have no access to, given I have a free account).
Please, is this possible?
Ideally, I would need a way to tell sphinx autodoc extension to generate documentation in rst instead of html, but I haven't found a way for this.
Is there another lib for this?
Thanks for any help,
Bests,
As proposed in comment from #mzjn, I used sphinxcontrib-restbuilder for this purpose.
Hyperlinks work, this is perfect for my need.
I applied it on the sphinx documentation of a public project of mine, and uploaded it on this github repo for those willing to have a look.
Click on index.rst and follow the read. There do be some glitches.
The API is documented in api.rst. This is really this part that is of interest for me.
I think it is nice enough.

Workflow to post on Jekyll via Windows

I am currently working on a Jekyll blog on Linux. However I'd like to add contributors to this blog who are using Windows and who haven't any skills in programming or using tools like Git etc.
I was wondering what could be the best process/pratice to enable them to post on the blog?
Installing them the entire environment and writing a script maybe?
Could it cause any issues due to the OS?
Any suggestions or advices are welcome :)
I don't think installing git, and pushing content to your repo is hard task for any non-tech guy.
1: Little tough way
Use team viewer and help your partner to setup git.
Allowed access to your repository.
Teach them, about frontmatter, and some jekyll commands.
2: Simple and smooth way.
Just get doc files dirctly from partner, which contain only content, nothing else, and convert yourself into markdown with manual frontmatter.
3: Create your own dashboard.
You can create your own dashoard like WordPress, where your partner can add categories, tags, title, meta description etc things, that can convert into frontmatter automatically. For that, you need to build yourself. (I find out that kind of generator here, but look's like he deleted, you can find it, by visiting him, old deleted commits).
I had the same problem so I ended up using Wordpress as the interface to it and creating a plugin to marry the systems up.
I figured I'd share it so feel free to have a look:
https://wordpress.org/plugins/wp2jekyll/

Joomla: alternative content for an article

I've just started work on an existing Joomla! site, and have a requirement to add an alternative language version of an article. Note that this isn't a full-internationalization effort - we don't need every part of the interface translated - just the need to have another 'version' of an article. Ideally, though, this would include more than just the core content - for example, title. I don't really want to create a second article because, in essence, this really is just a single article, and I don't want things like comments to be split between two separate articles.
Does anyone know if this can be done using joomla core?
If not, can anyone recommend an existing component that will do this?
A good component for manage translations in Joomla 1.5 is Joom!fish. It allows you to do a whole internationalization that, as you said, isn't exactly what you want to do. However I like to think in the long run so, if there's more change, I have not to restructure again and again just because of I haven't thought it before. Hence, if I were you, I would like to use Joom!fish anyway.
Well, as a short fix - Google Translator works and can be installed into your template you're using.
Then you can set it to be hidden unless the users browser is set to use a different language as default - then a small pop-up box drops down and it asks to translate it using google translate.
If that's not the option you're looking for - joom!fish is a good component others rave about but I don't have much experience with personally. Outside of that I'm not really sure.
Hanny had a good idea that would be really easy to implement in an article with the right extension. You can use this extension -
http://www.nonumber.nl/extensions/tabber
This would allow you to easily create tabs with the translations available anywhere you have them. The page above uses the extension to display the tabs, it would be trivial to implement.

Extend RedCloth via Redmine plugin?

I'm new to Ruby/Redmine/Redcloth but I'm trying to achieve the following:
The default way to build a link in Textile is "foo":http://bar. However, 90% of the day I use Atlassian products, which use [foo|http://bar] as link markup.
To keep everything a bit uniform I'd like to implement this in Redmine via a plugin. However, it appears that you can't change the macro syntax so instead I'll have to look into extending RedCloth to accept this form of inserting links.
Does anyone know how I can achieve this?
Thank you and merry christmas,
Dennis
You might consider switching to one of the two Markdown plugins (one is Markdown Extra-like, based on Bluefeather), which are a bit more similar in link style, although not the same as what you are used to. Since you use SO, though, you're obviously familiar with it.
Otherwise you'd have to write a full plugin, for which either of the plugins I've mentioned would serve as a good model. Best of luck.

Resources