[docs] reorder blog articles

[return42]

For details read along the commit messages

Hint: there a two patches with a fix in this PR:

• 97d801e
• f122cb0

[return42]

FYI: online HTML representation of this PR is available from https://return42.github.io/searxng/

[dalf]

I understand it makes a demo of the init function, but the parameter is not used.

Out of topic for this PR, engine_settings values are copied as attributes into the module. So engine_settings.get('name') could be name (with global _my_online_engine, name above).

And engine_settings can be:

{
    k: getattr(engine, k) 
    for k in dir(engine)
    if not k.startswith('__') and not callable(getattr(engine, k))
}

instead of get_engine_from_settings

[return42]

Hm, I guess I have a problem to understand why we have this argument engine_settings .. does it make sense to drop this argument? .. for me it was a bit confusing that we update module's name space with the values from YAML (engine_data):

searxng/searx/engines/__init__.py

Lines 117 to 125 in 5f76238

	def update_engine_attributes(engine, engine_data):
	# set engine attributes from engine_data
	for param_name, param_value in engine_data.items():
	if param_name == 'categories':
	if isinstance(param_value, str):
	param_value = list(map(str.strip, param_value.split(',')))
	engine.categories = param_value
	elif param_name != 'engine':
	setattr(engine, param_name, param_value)

and later, when the processor is initialized ...

searxng/searx/search/processors/abstract.py

Lines 70 to 72 in 5c5db71

	def initialize(self):
	try:
	self.engine.init(get_engine_from_settings(self.engine_name))

we call a function that gather engine_data from the YAML settings.

In sense of single point of definition I guess it is better to say, that everything is in the namespace of engine's modul and this can be configured by (is updated from) the YAML file.

But may be I'm totally wrong, since I do not have a complete overview.

[dalf]

Technically, names starting with _ can be overwritten but they can be None.

[return42]

Ooops .. I forgot to reflect your hint into the documentation. What Do you think, is it better to fix the documentation or is it better to fix the code that overrides private members?

[dalf]

I think it is better to fix the documentation.

[dalf]

LGTM